Struct Goal 

pub struct Goal {
    pub description: String,
    pub success_criteria: Vec<SuccessCriterion>,
    pub sub_goals: Vec<SubGoal>,
    pub status: GoalStatus,
}

Represents a structured goal with sub-goals and success criteria.

Goals help agents understand what they’re trying to achieve and how to measure success. Each goal can have multiple sub-goals and success criteria.

Examples

use ceylon_next::goal::{Goal, GoalStatus};

let mut goal = Goal::new("Build a REST API".to_string());

// Add success criteria
goal.add_criterion("API responds to HTTP requests".to_string());
goal.add_criterion("All endpoints return valid JSON".to_string());

// Add sub-goals in priority order
goal.add_sub_goal("Design API endpoints".to_string(), 1);
goal.add_sub_goal("Implement request handlers".to_string(), 2);
goal.add_sub_goal("Add error handling".to_string(), 3);

// Mark sub-goal as complete
goal.complete_sub_goal(0, Some("Endpoints designed".to_string()));

println!("{}", goal.get_summary());

Fields

description: String

What we’re trying to accomplish

success_criteria: Vec<SuccessCriterion>

How to know when we’re successful

sub_goals: Vec<SubGoal>

Smaller steps to achieve the goal

status: GoalStatus

Current status

Implementations

impl Goal

pub fn new(description: String) -> Self

Creates a new goal with the given description.

Arguments

• description - A description of what the goal aims to achieve

Examples found in repository

examples/05_with_goals.rs (lines 29-31)

async fn example_1_manual_goal() {
    println!("=== Example 1: Manual Goal Creation ===\n");

    // Create an agent
    let mut agent = Agent::new("MealPlanner", "ollama::gemma3:latest");

    // Create a goal manually for a complex task
    let mut goal = Goal::new(
        "Plan a healthy meal prep for the week".to_string()
    );

    // Define what success looks like
    println!("📋 Setting success criteria...");
    goal.add_criterion("7 breakfast recipes selected".to_string());
    goal.add_criterion("7 lunch recipes selected".to_string());
    goal.add_criterion("7 dinner recipes selected".to_string());
    goal.add_criterion("Shopping list created".to_string());
    goal.add_criterion("Prep schedule created".to_string());

    // Break down into steps (sub-goals)
    println!("🎯 Breaking down into sub-goals...\n");
    goal.add_sub_goal("Ask user about dietary preferences".to_string(), 0);
    goal.add_sub_goal("Ask about time available for prep".to_string(), 1);
    goal.add_sub_goal("Suggest breakfast options".to_string(), 2);
    goal.add_sub_goal("Suggest lunch options".to_string(), 3);
    goal.add_sub_goal("Suggest dinner options".to_string(), 4);
    goal.add_sub_goal("Create shopping list".to_string(), 5);
    goal.add_sub_goal("Create prep schedule".to_string(), 6);

    // Start working on the goal
    goal.status = GoalStatus::InProgress;

    // Set the goal on the agent
    agent.set_goal(goal.clone());

    // Create a task aligned with the goal
    let task = TaskRequest::new("I need help with meal planning");

    // Run the agent
    println!("⏳ Agent is working on the meal planning task...\n");
    let _response = agent.run(task).await;

    // Show the goal summary
    println!("\n📊 Goal Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 1 completed!\n");
}

// ============================================
// Example 2: Goal Progress Tracking
// ============================================

async fn example_2_goal_progress_tracking() {
    println!("\n=== Example 2: Goal Progress Tracking ===\n");

    // Create a goal for a project
    let mut goal = Goal::new(
        "Create a project plan for building a mobile app".to_string()
    );

    // Add success criteria
    goal.add_criterion("Project requirements documented".to_string());
    goal.add_criterion("Timeline created with milestones".to_string());
    goal.add_criterion("Resource allocation plan completed".to_string());
    goal.add_criterion("Risk assessment performed".to_string());

    // Add sub-goals
    goal.add_sub_goal("Gather stakeholder requirements".to_string(), 0);
    goal.add_sub_goal("Define project scope".to_string(), 1);
    goal.add_sub_goal("Create development timeline".to_string(), 2);
    goal.add_sub_goal("Allocate resources".to_string(), 3);
    goal.add_sub_goal("Identify risks and mitigation strategies".to_string(), 4);

    goal.status = GoalStatus::InProgress;

    // Simulate progress through the goal
    println!("📈 Tracking goal progress...\n");

    // Complete first sub-goal
    println!("Step 1: Gathering requirements");
    goal.complete_sub_goal(0, Some("Interviewed 5 stakeholders".to_string()));
    goal.mark_criterion_met(0, "Requirements documented".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete second sub-goal
    println!("Step 2: Defining scope");
    goal.complete_sub_goal(1, Some("Scope document created".to_string()));
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete third sub-goal
    println!("Step 3: Creating timeline");
    goal.complete_sub_goal(2, Some("12-month timeline with milestones".to_string()));
    goal.mark_criterion_met(1, "Timeline created".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fourth sub-goal
    println!("Step 4: Allocating resources");
    goal.complete_sub_goal(3, Some("Resource allocation table created".to_string()));
    goal.mark_criterion_met(2, "Resources allocated".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fifth sub-goal
    println!("Step 5: Assessing risks");
    goal.complete_sub_goal(4, Some("Risk register created with 8 identified risks".to_string()));
    goal.mark_criterion_met(3, "Risks identified".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Show final status
    println!("\n📊 Final Goal Status:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: Job Interview Preparation Goal
// ============================================

async fn example_3_interview_preparation() {
    println!("\n=== Example 3: Job Interview Preparation Goal ===\n");

    let mut agent = Agent::new("InterviewCoach", "ollama::gemma3:latest");

    // Create a structured goal for interview prep
    let mut goal = Goal::new(
        "Prepare for a senior software engineer interview at a tech company".to_string()
    );

    // Define success criteria
    println!("🎯 Success criteria:");
    goal.add_criterion("Technical topics reviewed (algorithms, data structures, system design)".to_string());
    goal.add_criterion("Behavioral questions prepared with STAR method examples".to_string());
    goal.add_criterion("Company research completed".to_string());
    goal.add_criterion("Practice mock interview conducted".to_string());
    goal.add_criterion("Questions to ask the interviewer prepared".to_string());

    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    // Define steps
    println!("\n📋 Steps to take:");
    goal.add_sub_goal("Review core algorithms and data structures".to_string(), 0);
    goal.add_sub_goal("Study system design patterns".to_string(), 1);
    goal.add_sub_goal("Prepare STAR method stories from past projects".to_string(), 2);
    goal.add_sub_goal("Research company background and culture".to_string(), 3);
    goal.add_sub_goal("Practice mock interview with a friend".to_string(), 4);
    goal.add_sub_goal("Prepare thoughtful questions about the role".to_string(), 5);

    for sub_goal in &goal.sub_goals {
        println!("  {}. {}", sub_goal.priority + 1, sub_goal.description);
    }

    goal.status = GoalStatus::InProgress;

    // Set goal on agent
    agent.set_goal(goal.clone());

    // Create related task
    let task = TaskRequest::new("Help me prepare for my senior engineer interview");

    println!("\n⏳ Agent is creating interview preparation plan...\n");
    let _response = agent.run(task).await;

    println!("\n📊 Goal Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Goal Analysis from Task Description
// ============================================

fn example_4_goal_analysis() {
    println!("\n=== Example 4: Goal Analysis from Task Description ===\n");

    // Simulate LLM analyzing a task and breaking it down into a goal
    let task_description = "Help me learn Python programming";

    println!("📝 Original task: \"{}\"", task_description);
    println!("\n🔍 LLM analyzing task...\n");

    // This is what the LLM would return
    let analysis = GoalAnalysis {
        main_goal: "Help user learn Python programming from basics to practical skills".to_string(),
        success_criteria: vec![
            "User's current skill level identified".to_string(),
            "Learning path created based on skill level".to_string(),
            "Resources (tutorials, books) provided".to_string(),
            "Practice exercises suggested".to_string(),
            "Study schedule created".to_string(),
        ],
        sub_goals: vec![
            "Ask about current programming experience".to_string(),
            "Identify learning goals (web dev, data science, etc)".to_string(),
            "Create structured learning path".to_string(),
            "Recommend learning resources".to_string(),
            "Suggest practice projects".to_string(),
            "Create study timeline".to_string(),
        ],
    };

    // Convert analysis to a Goal
    let goal = analysis.to_goal();

    println!("✅ Goal created from analysis:\n");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 4 completed!\n");
}

// ============================================
// Example 5: Goal Completion Verification
// ============================================

async fn example_5_goal_completion() {
    println!("\n=== Example 5: Goal Completion Verification ===\n");

    let mut goal = Goal::new("Plan a birthday party".to_string());

    // Set up success criteria
    goal.add_criterion("Guest list created".to_string());
    goal.add_criterion("Venue booked".to_string());
    goal.add_criterion("Food ordered".to_string());
    goal.add_criterion("Decorations purchased".to_string());

    // Set up sub-goals
    goal.add_sub_goal("Ask about guests".to_string(), 0);
    goal.add_sub_goal("Choose and book venue".to_string(), 1);
    goal.add_sub_goal("Order food".to_string(), 2);
    goal.add_sub_goal("Purchase decorations".to_string(), 3);

    goal.status = GoalStatus::InProgress;

    println!("🎉 Birthday party planning task started\n");
    println!("Initial progress: {}%\n", goal.get_progress());

    // Simulate completing tasks
    println!("Working through sub-goals:\n");

    // Task 1
    println!("✓ Contacted 15 friends and family members");
    goal.complete_sub_goal(0, Some("Got 15 confirmations".to_string()));
    goal.mark_criterion_met(0, "List of 15 guests confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 2
    println!("✓ Booked the community center for Saturday");
    goal.complete_sub_goal(1, Some("Community center reserved for 6pm".to_string()));
    goal.mark_criterion_met(1, "Community center booking confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 3
    println!("✓ Ordered pizza and drinks for 15 people");
    goal.complete_sub_goal(2, Some("Pizza and drinks ordered".to_string()));
    goal.mark_criterion_met(2, "Food catering arranged".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 4
    println!("✓ Bought balloons, streamers, and table decorations");
    goal.complete_sub_goal(3, Some("All decorations purchased".to_string()));
    goal.mark_criterion_met(3, "Decorations ready".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Check completion
    if goal.is_successful() {
        println!("🎊 All success criteria met!");
        goal.status = GoalStatus::Completed;
    }

    if goal.all_sub_goals_complete() {
        println!("✅ All sub-goals completed!");
    }

    println!("\nFinal Status:");
    println!("  Status: {:?}", goal.status);
    println!("  All criteria met: {}", goal.is_successful());
    println!("  Progress: {}%\n", goal.get_progress());

    println!("📊 Final Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 5 completed!\n");
}

// ============================================
// Example 6: Complex Multi-Step Project
// ============================================

async fn example_6_complex_project() {
    println!("\n=== Example 6: Complex Multi-Step Project Goal ===\n");

    let mut goal = Goal::new(
        "Launch a new web application product".to_string()
    );

    // Success criteria
    goal.add_criterion("Technical architecture designed and documented".to_string());
    goal.add_criterion("Frontend and backend development completed".to_string());
    goal.add_criterion("Testing completed (unit, integration, E2E)".to_string());
    goal.add_criterion("Deployment pipeline set up".to_string());
    goal.add_criterion("Marketing materials prepared".to_string());
    goal.add_criterion("Team trained on deployment and support".to_string());

    // Sub-goals in order
    goal.add_sub_goal("Define technical requirements and architecture".to_string(), 0);
    goal.add_sub_goal("Set up development environment and CI/CD".to_string(), 1);
    goal.add_sub_goal("Develop backend API endpoints".to_string(), 2);
    goal.add_sub_goal("Build frontend user interface".to_string(), 3);
    goal.add_sub_goal("Write comprehensive test suite".to_string(), 4);
    goal.add_sub_goal("Conduct security audit".to_string(), 5);
    goal.add_sub_goal("Set up monitoring and logging".to_string(), 6);
    goal.add_sub_goal("Deploy to staging environment".to_string(), 7);
    goal.add_sub_goal("Perform final testing and QA".to_string(), 8);
    goal.add_sub_goal("Create deployment documentation".to_string(), 9);
    goal.add_sub_goal("Train support team".to_string(), 10);
    goal.add_sub_goal("Deploy to production".to_string(), 11);

    goal.status = GoalStatus::InProgress;

    println!("🚀 Web Application Product Launch Plan\n");
    println!("Total steps: {}\n", goal.sub_goals.len());

    // Simulate progress
    let completed_steps = vec![
        (0, "Architecture documented with diagrams"),
        (1, "GitHub Actions CI/CD configured"),
        (2, "All 15 API endpoints implemented and tested"),
        (3, "React frontend with all pages completed"),
        (4, "Jest test suite with 85% coverage"),
        (5, "No critical vulnerabilities found"),
        (6, "Prometheus and ELK stack configured"),
        (7, "Successfully deployed to staging"),
        (8, "UAT passed with stakeholders"),
        (9, "Deployment runbook created"),
        (10, "Support team completed training"),
    ];

    for (index, notes) in completed_steps {
        goal.complete_sub_goal(index, Some(notes.to_string()));
    }

    // Mark success criteria as met
    goal.mark_criterion_met(0, "System design document completed".to_string());
    goal.mark_criterion_met(1, "All features implemented and tested".to_string());
    goal.mark_criterion_met(2, "85% test coverage achieved".to_string());
    goal.mark_criterion_met(3, "GitHub Actions and monitoring configured".to_string());
    goal.mark_criterion_met(4, "Marketing deck prepared".to_string());
    goal.mark_criterion_met(5, "Team completed deployment training".to_string());

    println!("📈 Project Progress:\n");
    println!("Overall Progress: {}%\n", goal.get_progress());

    println!("Remaining tasks:");
    if let Some(next) = goal.get_next_sub_goal() {
        println!("  • {}", next.description);
    }

    println!("\n📊 Status Summary:");
    println!("{}", goal.get_summary());

    if goal.get_progress() == 100 {
        println!("\n✅ All sub-goals completed!");
        if goal.is_successful() {
            println!("🎉 All success criteria met!");
            println!("Ready to mark goal as Completed!");
        }
    }

    println!("\n✅ Example 6 completed!\n");
}

examples/06_nextjs_app_generator.rs (lines 45-47)

async fn example_1_basic_nextjs_app() {
    println!("=== Example 1: Generate a Basic Next.js App ===\n");

    // Create an agent that will generate the app
    let mut agent = Agent::new("NextJsGenerator", "ollama::gemma3:latest");

    // Create a goal for generating a Next.js app
    let mut goal = Goal::new(
        "Generate a Next.js web application with essential structure".to_string()
    );

    // Define success criteria
    goal.add_criterion("package.json created with dependencies".to_string());
    goal.add_criterion("next.config.js configuration file generated".to_string());
    goal.add_criterion("pages directory with index and api route created".to_string());
    goal.add_criterion("styles directory with global CSS".to_string());
    goal.add_criterion("README.md with setup instructions".to_string());

    // Define sub-goals (steps to generate the app)
    goal.add_sub_goal("Analyze Next.js requirements and best practices".to_string(), 0);
    goal.add_sub_goal("Generate package.json with required dependencies".to_string(), 1);
    goal.add_sub_goal("Create next.config.js configuration".to_string(), 2);
    goal.add_sub_goal("Generate pages (index.tsx, _app.tsx, _document.tsx)".to_string(), 3);
    goal.add_sub_goal("Create API route examples".to_string(), 4);
    goal.add_sub_goal("Generate styling setup (global.css, utilities)".to_string(), 5);
    goal.add_sub_goal("Create components directory with example components".to_string(), 6);
    goal.add_sub_goal("Generate README with setup and usage instructions".to_string(), 7);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    // Create a task to generate a Next.js app
    let task = TaskRequest::new(
        "Generate a modern Next.js 14 application with TypeScript, Tailwind CSS, and best practices. \
         Include package.json, next.config.js, sample pages, API routes, and components. \
         The app should be production-ready and follow Next.js conventions."
    );

    println!("📝 Task: Generate a Next.js application\n");
    println!("🎯 Success Criteria:");
    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    println!("\n⏳ Agent is generating the Next.js app...\n");
    let response = agent.run(task).await;

    // Extract and display the output
    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    // Show progress
    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("Status: {:?}", goal.status);

    println!("\n✅ Example 1 completed!\n");
}

// ============================================
// Example 2: E-Commerce Next.js App
// ============================================

async fn example_2_ecommerce_app() {
    println!("\n=== Example 2: Generate E-Commerce Next.js App ===\n");

    let mut agent = Agent::new("EcommerceGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a complete e-commerce Next.js application".to_string()
    );

    // Success criteria for e-commerce
    goal.add_criterion("Product listing page with filtering and sorting".to_string());
    goal.add_criterion("Product detail pages with dynamic routes".to_string());
    goal.add_criterion("Shopping cart functionality".to_string());
    goal.add_criterion("User authentication setup".to_string());
    goal.add_criterion("Payment integration structure".to_string());
    goal.add_criterion("Database models and API endpoints".to_string());
    goal.add_criterion("Admin dashboard layout".to_string());

    // Sub-goals
    goal.add_sub_goal("Design database schema for products and orders".to_string(), 0);
    goal.add_sub_goal("Create product API endpoints".to_string(), 1);
    goal.add_sub_goal("Build product listing and search components".to_string(), 2);
    goal.add_sub_goal("Implement product detail pages".to_string(), 3);
    goal.add_sub_goal("Create shopping cart context and management".to_string(), 4);
    goal.add_sub_goal("Build checkout flow pages".to_string(), 5);
    goal.add_sub_goal("Integrate payment gateway API".to_string(), 6);
    goal.add_sub_goal("Create admin dashboard pages".to_string(), 7);
    goal.add_sub_goal("Add authentication middleware".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a complete e-commerce Next.js application with: \
         1. Product management system (listing, search, filters)\n\
         2. Shopping cart with add/remove/update functionality\n\
         3. User authentication and profile pages\n\
         4. Payment integration endpoints\n\
         5. Order history and tracking\n\
         6. Admin dashboard for managing products and orders\n\
         7. Database models for PostgreSQL or MongoDB\n\
         8. RESTful API endpoints\n\
         Use TypeScript, Tailwind CSS, and modern React patterns."
    );

    println!("📝 Task: Generate E-Commerce Next.js Application\n");
    println!("🎯 Features to Generate:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating e-commerce app...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: SaaS Dashboard App
// ============================================

async fn example_3_saas_dashboard() {
    println!("\n=== Example 3: Generate SaaS Dashboard Next.js App ===\n");

    let mut agent = Agent::new("SaasDashboardGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a SaaS dashboard application with user management".to_string()
    );

    goal.add_criterion("User authentication and authorization".to_string());
    goal.add_criterion("Multi-tenant database structure".to_string());
    goal.add_criterion("Dashboard with analytics and metrics".to_string());
    goal.add_criterion("User and team management pages".to_string());
    goal.add_criterion("Settings and preferences pages".to_string());
    goal.add_criterion("Billing and subscription management".to_string());
    goal.add_criterion("API for data collection and reporting".to_string());

    goal.add_sub_goal("Design multi-tenant database schema".to_string(), 0);
    goal.add_sub_goal("Implement OAuth authentication".to_string(), 1);
    goal.add_sub_goal("Create dashboard with charts and metrics".to_string(), 2);
    goal.add_sub_goal("Build team and user management interfaces".to_string(), 3);
    goal.add_sub_goal("Create settings pages for users and organization".to_string(), 4);
    goal.add_sub_goal("Implement billing API integration".to_string(), 5);
    goal.add_sub_goal("Create analytics and reporting system".to_string(), 6);
    goal.add_sub_goal("Add email notification templates".to_string(), 7);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a complete SaaS dashboard Next.js application with:\n\
         1. Multi-tenant authentication (OAuth + JWT)\n\
         2. Organization and team management\n\
         3. Comprehensive dashboard with charts and analytics\n\
         4. User permission and role management\n\
         5. Billing integration with Stripe\n\
         6. Settings pages for users and teams\n\
         7. Email notifications system\n\
         8. API logging and activity tracking\n\
         9. Dark mode support\n\
         10. Mobile responsive design\n\
         Include TypeScript, Tailwind CSS, Recharts for visualizations, \
         and PostgreSQL database models."
    );

    println!("📝 Task: Generate SaaS Dashboard Application\n");
    println!("🎯 Dashboard Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating SaaS dashboard...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Blog Platform with CMS
// ============================================

async fn example_4_blog_platform() {
    println!("\n=== Example 4: Generate Blog Platform with CMS ===\n");

    let mut agent = Agent::new("BlogCMSGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a comprehensive blog platform with CMS".to_string()
    );

    goal.add_criterion("Blog post management system".to_string());
    goal.add_criterion("Rich text editor with markdown support".to_string());
    goal.add_criterion("Category and tag system".to_string());
    goal.add_criterion("Search and filtering functionality".to_string());
    goal.add_criterion("Comments system with moderation".to_string());
    goal.add_criterion("SEO optimization (meta tags, sitemap)".to_string());
    goal.add_criterion("Author management and permissions".to_string());
    goal.add_criterion("Analytics and engagement tracking".to_string());

    goal.add_sub_goal("Design blog database schema".to_string(), 0);
    goal.add_sub_goal("Create CMS backend API".to_string(), 1);
    goal.add_sub_goal("Build post editor with markdown".to_string(), 2);
    goal.add_sub_goal("Create blog listing and search pages".to_string(), 3);
    goal.add_sub_goal("Build individual post pages with SEO".to_string(), 4);
    goal.add_sub_goal("Implement comments system".to_string(), 5);
    goal.add_sub_goal("Create author profiles and bio".to_string(), 6);
    goal.add_sub_goal("Build admin dashboard for content management".to_string(), 7);
    goal.add_sub_goal("Add analytics tracking and reporting".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a full-featured blog platform with CMS:\n\
         1. Post creation and editing with rich text editor\n\
         2. Markdown support with preview\n\
         3. Category and tag system\n\
         4. Advanced search with filters\n\
         5. Comments system with nested replies\n\
         6. Author profiles with biography\n\
         7. SEO optimization (sitemaps, meta tags, structured data)\n\
         8. Social sharing integration\n\
         9. Email newsletter subscription\n\
         10. Analytics dashboard for authors\n\
         11. Reading time estimates\n\
         12. Related posts suggestions\n\
         Include TypeScript, Tailwind CSS, next-mdx-remote for markdown, \
         and MongoDB/PostgreSQL models."
    );

    println!("📝 Task: Generate Blog Platform with CMS\n");
    println!("🎯 Blog Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating blog platform...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 4 completed!\n");
}

examples/07_python_project_generator.rs (lines 115-117)

async fn example_1_basic_cli_app() {
    println!("=== Example 1: Generate a Basic Python CLI Application ===\n");

    let mut agent = Agent::new("PythonCliGenerator", "ollama::gemma3:latest");

    // Create a goal for generating a Python CLI app
    let mut goal = Goal::new(
        "Generate a Python command-line application with core structure".to_string()
    );

    // Define success criteria
    goal.add_criterion("requirements.txt with dependencies listed".to_string());
    goal.add_criterion("setup.py or pyproject.toml for packaging".to_string());
    goal.add_criterion("Main CLI entry point with argument parsing".to_string());
    goal.add_criterion("Command structure with subcommands".to_string());
    goal.add_criterion("Basic error handling and logging".to_string());
    goal.add_criterion("README.md with usage instructions".to_string());
    goal.add_criterion(".gitignore for Python projects".to_string());

    // Define sub-goals (steps to generate the app)
    goal.add_sub_goal("Analyze Python CLI best practices".to_string(), 0);
    goal.add_sub_goal("Generate project structure and directories".to_string(), 1);
    goal.add_sub_goal("Create requirements.txt with dependencies (Click, Typer, etc)".to_string(), 2);
    goal.add_sub_goal("Generate pyproject.toml or setup.py".to_string(), 3);
    goal.add_sub_goal("Create main CLI module with argument parser".to_string(), 4);
    goal.add_sub_goal("Generate subcommands and command handlers".to_string(), 5);
    goal.add_sub_goal("Create utility modules and helpers".to_string(), 6);
    goal.add_sub_goal("Add logging and error handling".to_string(), 7);
    goal.add_sub_goal("Generate README with installation and usage".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    // Create a task to generate a Python CLI app
    let task = TaskRequest::new(
        "Generate a professional Python command-line application with the following structure:\n\
         1. Modern argument parsing using Click or Typer\n\
         2. Multiple subcommands (e.g., init, run, config, help)\n\
         3. Configuration file support (YAML or JSON)\n\
         4. Logging with different verbosity levels\n\
         5. Error handling and graceful failure messages\n\
         6. Proper project structure with src/ and tests/ directories\n\
         7. pyproject.toml or setup.py for packaging\n\
         8. requirements.txt with dev dependencies\n\
         9. .gitignore for Python\n\
         10. Comprehensive README with examples\n\
         The app should be production-ready and follow Python best practices (PEP 8)."
    );

    println!("📝 Task: Generate a Python CLI Application\n");
    println!("🎯 Success Criteria:");
    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    println!("\n⏳ Agent is generating the Python CLI app...\n");
    let response = agent.run(task).await;

    // Extract and display the output
    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    // Show progress
    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("Status: {:?}", goal.status);

    println!("\n✅ Example 1 completed!\n");
}

// ============================================
// Example 2: Python Web API with FastAPI
// ============================================

async fn example_2_fastapi_web_app() {
    println!("\n=== Example 2: Generate Python FastAPI Web Application ===\n");

    let mut agent = Agent::new("FastApiGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a complete FastAPI web application with database integration".to_string()
    );

    // Success criteria for FastAPI app
    goal.add_criterion("FastAPI application structure with routers".to_string());
    goal.add_criterion("Database models using SQLAlchemy".to_string());
    goal.add_criterion("RESTful API endpoints with CRUD operations".to_string());
    goal.add_criterion("Request/response schemas using Pydantic".to_string());
    goal.add_criterion("Authentication and authorization middleware".to_string());
    goal.add_criterion("Database migrations with Alembic".to_string());
    goal.add_criterion("Configuration management with environment variables".to_string());
    goal.add_criterion("Unit and integration test examples".to_string());
    goal.add_criterion("Docker setup for containerization".to_string());

    // Sub-goals
    goal.add_sub_goal("Design REST API endpoints structure".to_string(), 0);
    goal.add_sub_goal("Create Pydantic models for request/response validation".to_string(), 1);
    goal.add_sub_goal("Set up SQLAlchemy ORM with database models".to_string(), 2);
    goal.add_sub_goal("Implement CRUD routers for resources".to_string(), 3);
    goal.add_sub_goal("Add authentication and JWT tokens".to_string(), 4);
    goal.add_sub_goal("Create Alembic migrations setup".to_string(), 5);
    goal.add_sub_goal("Set up configuration with environment variables".to_string(), 6);
    goal.add_sub_goal("Create test fixtures and example tests".to_string(), 7);
    goal.add_sub_goal("Generate Docker and docker-compose files".to_string(), 8);
    goal.add_sub_goal("Create comprehensive API documentation".to_string(), 9);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a production-ready FastAPI web application with:\n\
         1. Modular project structure with routers for different resources\n\
         2. Pydantic models for request/response validation\n\
         3. SQLAlchemy ORM setup with database models\n\
         4. CRUD operations for users, products, and orders\n\
         5. JWT authentication and authorization middleware\n\
         6. Role-based access control (RBAC)\n\
         7. Alembic database migrations\n\
         8. Environment configuration (.env support)\n\
         9. Error handling with proper HTTP status codes\n\
         10. Logging configuration\n\
         11. Unit tests with pytest\n\
         12. Integration tests with test database\n\
         13. Docker and docker-compose for local development\n\
         14. requirements.txt with all dependencies\n\
         15. Comprehensive API documentation\n\
         Use async/await patterns, follow REST conventions, and include examples."
    );

    println!("📝 Task: Generate FastAPI Web Application\n");
    println!("🎯 FastAPI Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating FastAPI app...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: Python Data Science Project
// ============================================

async fn example_3_data_science_project() {
    println!("\n=== Example 3: Generate Python Data Science Project ===\n");

    let mut agent = Agent::new("DataScienceGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a data science project with ML pipeline and analysis".to_string()
    );

    goal.add_criterion("Project structure following cookiecutter-data-science".to_string());
    goal.add_criterion("Data loading and preprocessing modules".to_string());
    goal.add_criterion("Exploratory data analysis (EDA) notebooks".to_string());
    goal.add_criterion("Feature engineering pipeline".to_string());
    goal.add_criterion("Model training and evaluation".to_string());
    goal.add_criterion("Hyperparameter tuning setup".to_string());
    goal.add_criterion("Model persistence and versioning".to_string());
    goal.add_criterion("Visualization utilities".to_string());
    goal.add_criterion("Unit tests for data pipeline".to_string());

    goal.add_sub_goal("Create cookiecutter-style directory structure".to_string(), 0);
    goal.add_sub_goal("Set up Jupyter notebook for EDA".to_string(), 1);
    goal.add_sub_goal("Create data loading and preprocessing modules".to_string(), 2);
    goal.add_sub_goal("Implement feature engineering pipeline".to_string(), 3);
    goal.add_sub_goal("Set up scikit-learn model training".to_string(), 4);
    goal.add_sub_goal("Create model evaluation and metrics".to_string(), 5);
    goal.add_sub_goal("Implement hyperparameter tuning with GridSearchCV".to_string(), 6);
    goal.add_sub_goal("Add model persistence with joblib/pickle".to_string(), 7);
    goal.add_sub_goal("Create visualization utilities with matplotlib/seaborn".to_string(), 8);
    goal.add_sub_goal("Write tests for data pipeline".to_string(), 9);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a comprehensive Python data science project with:\n\
         1. Proper project structure for data science work\n\
         2. Data loading module supporting CSV, JSON, Parquet\n\
         3. Data preprocessing and validation pipeline\n\
         4. Exploratory Data Analysis (EDA) notebook template\n\
         5. Feature engineering module\n\
         6. Model training with scikit-learn or XGBoost\n\
         7. Cross-validation and evaluation metrics\n\
         8. Hyperparameter tuning with GridSearchCV/RandomSearch\n\
         9. Model persistence and loading utilities\n\
         10. Visualization utilities (matplotlib, seaborn, plotly)\n\
         11. Unit tests for data loading and preprocessing\n\
         12. Configuration management for experiments\n\
         13. Logging for training pipeline\n\
         14. Requirements.txt with ML libraries (pandas, numpy, scikit-learn)\n\
         15. Makefile for common tasks\n\
         16. README with dataset description and results\n\
         Include example workflows and best practices for reproducibility."
    );

    println!("📝 Task: Generate Data Science Project\n");
    println!("🎯 Data Science Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating data science project...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Python Package/Library
// ============================================

async fn example_4_python_library() {
    println!("\n=== Example 4: Generate Python Library/Package ===\n");

    let mut agent = Agent::new("PythonLibraryGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a well-structured Python package ready for distribution".to_string()
    );

    goal.add_criterion("Proper package structure with namespace".to_string());
    goal.add_criterion("setup.py and pyproject.toml for distribution".to_string());
    goal.add_criterion("Comprehensive docstrings and type hints".to_string());
    goal.add_criterion("Unit tests with pytest".to_string());
    goal.add_criterion("Documentation with Sphinx".to_string());
    goal.add_criterion("CI/CD configuration (GitHub Actions)".to_string());
    goal.add_criterion("Version management strategy".to_string());
    goal.add_criterion("Contributing guidelines".to_string());

    goal.add_sub_goal("Create package structure with __init__.py files".to_string(), 0);
    goal.add_sub_goal("Write setup.py and pyproject.toml".to_string(), 1);
    goal.add_sub_goal("Create core modules with type hints".to_string(), 2);
    goal.add_sub_goal("Add comprehensive docstrings".to_string(), 3);
    goal.add_sub_goal("Create test structure with pytest".to_string(), 4);
    goal.add_sub_goal("Set up documentation with Sphinx".to_string(), 5);
    goal.add_sub_goal("Create GitHub Actions workflows".to_string(), 6);
    goal.add_sub_goal("Add CONTRIBUTING.md and CODE_OF_CONDUCT.md".to_string(), 7);
    goal.add_sub_goal("Create MANIFEST.in and manifest files".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a professional Python library/package with:\n\
         1. Standard package structure (src layout)\n\
         2. __init__.py with version and exports\n\
         3. Core modules with complete implementations\n\
         4. Type hints throughout (PEP 484)\n\
         5. Comprehensive docstrings (Google style)\n\
         6. setup.py with metadata\n\
         7. pyproject.toml with build system\n\
         8. MANIFEST.in for package data\n\
         9. Pytest test structure with fixtures\n\
         10. pytest.ini configuration\n\
         11. Sphinx documentation setup\n\
         12. GitHub Actions workflow for CI/CD\n\
         13. Pre-commit hooks configuration\n\
         14. LICENSE (MIT or Apache 2.0)\n\
         15. .gitignore for Python\n\
         16. README.md with installation and usage\n\
         17. CONTRIBUTING.md for contributors\n\
         18. CODE_OF_CONDUCT.md\n\
         19. Changelog/HISTORY.md template\n\
         20. Version management with __version__\n\
         Include examples for public API and best practices for library development."
    );

    println!("📝 Task: Generate Python Library Package\n");
    println!("🎯 Library Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating Python library...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 4 completed!\n");
}

// ============================================
// Example 5: Django Web Application
// ============================================

async fn example_5_django_web_app() {
    println!("\n=== Example 5: Generate Django Web Application ===\n");

    let mut agent = Agent::new("DjangoGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a complete Django web application with admin and authentication".to_string()
    );

    goal.add_criterion("Django project structure with multiple apps".to_string());
    goal.add_criterion("Custom user model implementation".to_string());
    goal.add_criterion("Database models for core features".to_string());
    goal.add_criterion("Admin interface customization".to_string());
    goal.add_criterion("Views and URL routing".to_string());
    goal.add_criterion("Templates with Bootstrap styling".to_string());
    goal.add_criterion("Authentication and permissions".to_string());
    goal.add_criterion("Database migrations".to_string());
    goal.add_criterion("Django REST Framework API".to_string());

    goal.add_sub_goal("Create Django project and app structure".to_string(), 0);
    goal.add_sub_goal("Design and implement custom user model".to_string(), 1);
    goal.add_sub_goal("Create models for core features".to_string(), 2);
    goal.add_sub_goal("Configure admin interface".to_string(), 3);
    goal.add_sub_goal("Create views and templates".to_string(), 4);
    goal.add_sub_goal("Set up URL routing".to_string(), 5);
    goal.add_sub_goal("Implement authentication views".to_string(), 6);
    goal.add_sub_goal("Create Django REST Framework serializers".to_string(), 7);
    goal.add_sub_goal("Set up static files and media handling".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a full-featured Django web application with:\n\
         1. Django project structure with multiple apps\n\
         2. Custom user model extending AbstractBaseUser\n\
         3. Models for main features (e.g., Blog posts, Comments, Categories)\n\
         4. Django ORM relationships (ForeignKey, ManyToMany)\n\
         5. Admin interface with custom actions\n\
         6. Class-based views (ListView, DetailView, CreateView)\n\
         7. Django templates with template inheritance\n\
         8. Bootstrap styling integration\n\
         9. Authentication and login required decorators\n\
         10. Permission-based access control\n\
         11. Database migrations\n\
         12. Forms with validation\n\
         13. Django REST Framework setup\n\
         14. API serializers and viewsets\n\
         15. Pagination and filtering\n\
         16. Settings for dev and production\n\
         17. Environment variable configuration\n\
         18. Logging configuration\n\
         19. Tests with Django TestCase\n\
         20. Static files and media management\n\
         21. Docker setup\n\
         22. Requirements.txt\n\
         Include examples and docstrings following Django conventions."
    );

    println!("📝 Task: Generate Django Web Application\n");
    println!("🎯 Django Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating Django app...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 5 completed!\n");
}

pub fn add_criterion(&mut self, description: String)

Adds a success criterion to the goal.

Arguments

• description - The condition that must be true for success

Examples found in repository

examples/05_with_goals.rs (line 35)

async fn example_1_manual_goal() {
    println!("=== Example 1: Manual Goal Creation ===\n");

    // Create an agent
    let mut agent = Agent::new("MealPlanner", "ollama::gemma3:latest");

    // Create a goal manually for a complex task
    let mut goal = Goal::new(
        "Plan a healthy meal prep for the week".to_string()
    );

    // Define what success looks like
    println!("📋 Setting success criteria...");
    goal.add_criterion("7 breakfast recipes selected".to_string());
    goal.add_criterion("7 lunch recipes selected".to_string());
    goal.add_criterion("7 dinner recipes selected".to_string());
    goal.add_criterion("Shopping list created".to_string());
    goal.add_criterion("Prep schedule created".to_string());

    // Break down into steps (sub-goals)
    println!("🎯 Breaking down into sub-goals...\n");
    goal.add_sub_goal("Ask user about dietary preferences".to_string(), 0);
    goal.add_sub_goal("Ask about time available for prep".to_string(), 1);
    goal.add_sub_goal("Suggest breakfast options".to_string(), 2);
    goal.add_sub_goal("Suggest lunch options".to_string(), 3);
    goal.add_sub_goal("Suggest dinner options".to_string(), 4);
    goal.add_sub_goal("Create shopping list".to_string(), 5);
    goal.add_sub_goal("Create prep schedule".to_string(), 6);

    // Start working on the goal
    goal.status = GoalStatus::InProgress;

    // Set the goal on the agent
    agent.set_goal(goal.clone());

    // Create a task aligned with the goal
    let task = TaskRequest::new("I need help with meal planning");

    // Run the agent
    println!("⏳ Agent is working on the meal planning task...\n");
    let _response = agent.run(task).await;

    // Show the goal summary
    println!("\n📊 Goal Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 1 completed!\n");
}

// ============================================
// Example 2: Goal Progress Tracking
// ============================================

async fn example_2_goal_progress_tracking() {
    println!("\n=== Example 2: Goal Progress Tracking ===\n");

    // Create a goal for a project
    let mut goal = Goal::new(
        "Create a project plan for building a mobile app".to_string()
    );

    // Add success criteria
    goal.add_criterion("Project requirements documented".to_string());
    goal.add_criterion("Timeline created with milestones".to_string());
    goal.add_criterion("Resource allocation plan completed".to_string());
    goal.add_criterion("Risk assessment performed".to_string());

    // Add sub-goals
    goal.add_sub_goal("Gather stakeholder requirements".to_string(), 0);
    goal.add_sub_goal("Define project scope".to_string(), 1);
    goal.add_sub_goal("Create development timeline".to_string(), 2);
    goal.add_sub_goal("Allocate resources".to_string(), 3);
    goal.add_sub_goal("Identify risks and mitigation strategies".to_string(), 4);

    goal.status = GoalStatus::InProgress;

    // Simulate progress through the goal
    println!("📈 Tracking goal progress...\n");

    // Complete first sub-goal
    println!("Step 1: Gathering requirements");
    goal.complete_sub_goal(0, Some("Interviewed 5 stakeholders".to_string()));
    goal.mark_criterion_met(0, "Requirements documented".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete second sub-goal
    println!("Step 2: Defining scope");
    goal.complete_sub_goal(1, Some("Scope document created".to_string()));
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete third sub-goal
    println!("Step 3: Creating timeline");
    goal.complete_sub_goal(2, Some("12-month timeline with milestones".to_string()));
    goal.mark_criterion_met(1, "Timeline created".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fourth sub-goal
    println!("Step 4: Allocating resources");
    goal.complete_sub_goal(3, Some("Resource allocation table created".to_string()));
    goal.mark_criterion_met(2, "Resources allocated".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fifth sub-goal
    println!("Step 5: Assessing risks");
    goal.complete_sub_goal(4, Some("Risk register created with 8 identified risks".to_string()));
    goal.mark_criterion_met(3, "Risks identified".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Show final status
    println!("\n📊 Final Goal Status:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: Job Interview Preparation Goal
// ============================================

async fn example_3_interview_preparation() {
    println!("\n=== Example 3: Job Interview Preparation Goal ===\n");

    let mut agent = Agent::new("InterviewCoach", "ollama::gemma3:latest");

    // Create a structured goal for interview prep
    let mut goal = Goal::new(
        "Prepare for a senior software engineer interview at a tech company".to_string()
    );

    // Define success criteria
    println!("🎯 Success criteria:");
    goal.add_criterion("Technical topics reviewed (algorithms, data structures, system design)".to_string());
    goal.add_criterion("Behavioral questions prepared with STAR method examples".to_string());
    goal.add_criterion("Company research completed".to_string());
    goal.add_criterion("Practice mock interview conducted".to_string());
    goal.add_criterion("Questions to ask the interviewer prepared".to_string());

    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    // Define steps
    println!("\n📋 Steps to take:");
    goal.add_sub_goal("Review core algorithms and data structures".to_string(), 0);
    goal.add_sub_goal("Study system design patterns".to_string(), 1);
    goal.add_sub_goal("Prepare STAR method stories from past projects".to_string(), 2);
    goal.add_sub_goal("Research company background and culture".to_string(), 3);
    goal.add_sub_goal("Practice mock interview with a friend".to_string(), 4);
    goal.add_sub_goal("Prepare thoughtful questions about the role".to_string(), 5);

    for sub_goal in &goal.sub_goals {
        println!("  {}. {}", sub_goal.priority + 1, sub_goal.description);
    }

    goal.status = GoalStatus::InProgress;

    // Set goal on agent
    agent.set_goal(goal.clone());

    // Create related task
    let task = TaskRequest::new("Help me prepare for my senior engineer interview");

    println!("\n⏳ Agent is creating interview preparation plan...\n");
    let _response = agent.run(task).await;

    println!("\n📊 Goal Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Goal Analysis from Task Description
// ============================================

fn example_4_goal_analysis() {
    println!("\n=== Example 4: Goal Analysis from Task Description ===\n");

    // Simulate LLM analyzing a task and breaking it down into a goal
    let task_description = "Help me learn Python programming";

    println!("📝 Original task: \"{}\"", task_description);
    println!("\n🔍 LLM analyzing task...\n");

    // This is what the LLM would return
    let analysis = GoalAnalysis {
        main_goal: "Help user learn Python programming from basics to practical skills".to_string(),
        success_criteria: vec![
            "User's current skill level identified".to_string(),
            "Learning path created based on skill level".to_string(),
            "Resources (tutorials, books) provided".to_string(),
            "Practice exercises suggested".to_string(),
            "Study schedule created".to_string(),
        ],
        sub_goals: vec![
            "Ask about current programming experience".to_string(),
            "Identify learning goals (web dev, data science, etc)".to_string(),
            "Create structured learning path".to_string(),
            "Recommend learning resources".to_string(),
            "Suggest practice projects".to_string(),
            "Create study timeline".to_string(),
        ],
    };

    // Convert analysis to a Goal
    let goal = analysis.to_goal();

    println!("✅ Goal created from analysis:\n");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 4 completed!\n");
}

// ============================================
// Example 5: Goal Completion Verification
// ============================================

async fn example_5_goal_completion() {
    println!("\n=== Example 5: Goal Completion Verification ===\n");

    let mut goal = Goal::new("Plan a birthday party".to_string());

    // Set up success criteria
    goal.add_criterion("Guest list created".to_string());
    goal.add_criterion("Venue booked".to_string());
    goal.add_criterion("Food ordered".to_string());
    goal.add_criterion("Decorations purchased".to_string());

    // Set up sub-goals
    goal.add_sub_goal("Ask about guests".to_string(), 0);
    goal.add_sub_goal("Choose and book venue".to_string(), 1);
    goal.add_sub_goal("Order food".to_string(), 2);
    goal.add_sub_goal("Purchase decorations".to_string(), 3);

    goal.status = GoalStatus::InProgress;

    println!("🎉 Birthday party planning task started\n");
    println!("Initial progress: {}%\n", goal.get_progress());

    // Simulate completing tasks
    println!("Working through sub-goals:\n");

    // Task 1
    println!("✓ Contacted 15 friends and family members");
    goal.complete_sub_goal(0, Some("Got 15 confirmations".to_string()));
    goal.mark_criterion_met(0, "List of 15 guests confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 2
    println!("✓ Booked the community center for Saturday");
    goal.complete_sub_goal(1, Some("Community center reserved for 6pm".to_string()));
    goal.mark_criterion_met(1, "Community center booking confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 3
    println!("✓ Ordered pizza and drinks for 15 people");
    goal.complete_sub_goal(2, Some("Pizza and drinks ordered".to_string()));
    goal.mark_criterion_met(2, "Food catering arranged".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 4
    println!("✓ Bought balloons, streamers, and table decorations");
    goal.complete_sub_goal(3, Some("All decorations purchased".to_string()));
    goal.mark_criterion_met(3, "Decorations ready".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Check completion
    if goal.is_successful() {
        println!("🎊 All success criteria met!");
        goal.status = GoalStatus::Completed;
    }

    if goal.all_sub_goals_complete() {
        println!("✅ All sub-goals completed!");
    }

    println!("\nFinal Status:");
    println!("  Status: {:?}", goal.status);
    println!("  All criteria met: {}", goal.is_successful());
    println!("  Progress: {}%\n", goal.get_progress());

    println!("📊 Final Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 5 completed!\n");
}

// ============================================
// Example 6: Complex Multi-Step Project
// ============================================

async fn example_6_complex_project() {
    println!("\n=== Example 6: Complex Multi-Step Project Goal ===\n");

    let mut goal = Goal::new(
        "Launch a new web application product".to_string()
    );

    // Success criteria
    goal.add_criterion("Technical architecture designed and documented".to_string());
    goal.add_criterion("Frontend and backend development completed".to_string());
    goal.add_criterion("Testing completed (unit, integration, E2E)".to_string());
    goal.add_criterion("Deployment pipeline set up".to_string());
    goal.add_criterion("Marketing materials prepared".to_string());
    goal.add_criterion("Team trained on deployment and support".to_string());

    // Sub-goals in order
    goal.add_sub_goal("Define technical requirements and architecture".to_string(), 0);
    goal.add_sub_goal("Set up development environment and CI/CD".to_string(), 1);
    goal.add_sub_goal("Develop backend API endpoints".to_string(), 2);
    goal.add_sub_goal("Build frontend user interface".to_string(), 3);
    goal.add_sub_goal("Write comprehensive test suite".to_string(), 4);
    goal.add_sub_goal("Conduct security audit".to_string(), 5);
    goal.add_sub_goal("Set up monitoring and logging".to_string(), 6);
    goal.add_sub_goal("Deploy to staging environment".to_string(), 7);
    goal.add_sub_goal("Perform final testing and QA".to_string(), 8);
    goal.add_sub_goal("Create deployment documentation".to_string(), 9);
    goal.add_sub_goal("Train support team".to_string(), 10);
    goal.add_sub_goal("Deploy to production".to_string(), 11);

    goal.status = GoalStatus::InProgress;

    println!("🚀 Web Application Product Launch Plan\n");
    println!("Total steps: {}\n", goal.sub_goals.len());

    // Simulate progress
    let completed_steps = vec![
        (0, "Architecture documented with diagrams"),
        (1, "GitHub Actions CI/CD configured"),
        (2, "All 15 API endpoints implemented and tested"),
        (3, "React frontend with all pages completed"),
        (4, "Jest test suite with 85% coverage"),
        (5, "No critical vulnerabilities found"),
        (6, "Prometheus and ELK stack configured"),
        (7, "Successfully deployed to staging"),
        (8, "UAT passed with stakeholders"),
        (9, "Deployment runbook created"),
        (10, "Support team completed training"),
    ];

    for (index, notes) in completed_steps {
        goal.complete_sub_goal(index, Some(notes.to_string()));
    }

    // Mark success criteria as met
    goal.mark_criterion_met(0, "System design document completed".to_string());
    goal.mark_criterion_met(1, "All features implemented and tested".to_string());
    goal.mark_criterion_met(2, "85% test coverage achieved".to_string());
    goal.mark_criterion_met(3, "GitHub Actions and monitoring configured".to_string());
    goal.mark_criterion_met(4, "Marketing deck prepared".to_string());
    goal.mark_criterion_met(5, "Team completed deployment training".to_string());

    println!("📈 Project Progress:\n");
    println!("Overall Progress: {}%\n", goal.get_progress());

    println!("Remaining tasks:");
    if let Some(next) = goal.get_next_sub_goal() {
        println!("  • {}", next.description);
    }

    println!("\n📊 Status Summary:");
    println!("{}", goal.get_summary());

    if goal.get_progress() == 100 {
        println!("\n✅ All sub-goals completed!");
        if goal.is_successful() {
            println!("🎉 All success criteria met!");
            println!("Ready to mark goal as Completed!");
        }
    }

    println!("\n✅ Example 6 completed!\n");
}

examples/06_nextjs_app_generator.rs (line 50)

async fn example_1_basic_nextjs_app() {
    println!("=== Example 1: Generate a Basic Next.js App ===\n");

    // Create an agent that will generate the app
    let mut agent = Agent::new("NextJsGenerator", "ollama::gemma3:latest");

    // Create a goal for generating a Next.js app
    let mut goal = Goal::new(
        "Generate a Next.js web application with essential structure".to_string()
    );

    // Define success criteria
    goal.add_criterion("package.json created with dependencies".to_string());
    goal.add_criterion("next.config.js configuration file generated".to_string());
    goal.add_criterion("pages directory with index and api route created".to_string());
    goal.add_criterion("styles directory with global CSS".to_string());
    goal.add_criterion("README.md with setup instructions".to_string());

    // Define sub-goals (steps to generate the app)
    goal.add_sub_goal("Analyze Next.js requirements and best practices".to_string(), 0);
    goal.add_sub_goal("Generate package.json with required dependencies".to_string(), 1);
    goal.add_sub_goal("Create next.config.js configuration".to_string(), 2);
    goal.add_sub_goal("Generate pages (index.tsx, _app.tsx, _document.tsx)".to_string(), 3);
    goal.add_sub_goal("Create API route examples".to_string(), 4);
    goal.add_sub_goal("Generate styling setup (global.css, utilities)".to_string(), 5);
    goal.add_sub_goal("Create components directory with example components".to_string(), 6);
    goal.add_sub_goal("Generate README with setup and usage instructions".to_string(), 7);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    // Create a task to generate a Next.js app
    let task = TaskRequest::new(
        "Generate a modern Next.js 14 application with TypeScript, Tailwind CSS, and best practices. \
         Include package.json, next.config.js, sample pages, API routes, and components. \
         The app should be production-ready and follow Next.js conventions."
    );

    println!("📝 Task: Generate a Next.js application\n");
    println!("🎯 Success Criteria:");
    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    println!("\n⏳ Agent is generating the Next.js app...\n");
    let response = agent.run(task).await;

    // Extract and display the output
    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    // Show progress
    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("Status: {:?}", goal.status);

    println!("\n✅ Example 1 completed!\n");
}

// ============================================
// Example 2: E-Commerce Next.js App
// ============================================

async fn example_2_ecommerce_app() {
    println!("\n=== Example 2: Generate E-Commerce Next.js App ===\n");

    let mut agent = Agent::new("EcommerceGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a complete e-commerce Next.js application".to_string()
    );

    // Success criteria for e-commerce
    goal.add_criterion("Product listing page with filtering and sorting".to_string());
    goal.add_criterion("Product detail pages with dynamic routes".to_string());
    goal.add_criterion("Shopping cart functionality".to_string());
    goal.add_criterion("User authentication setup".to_string());
    goal.add_criterion("Payment integration structure".to_string());
    goal.add_criterion("Database models and API endpoints".to_string());
    goal.add_criterion("Admin dashboard layout".to_string());

    // Sub-goals
    goal.add_sub_goal("Design database schema for products and orders".to_string(), 0);
    goal.add_sub_goal("Create product API endpoints".to_string(), 1);
    goal.add_sub_goal("Build product listing and search components".to_string(), 2);
    goal.add_sub_goal("Implement product detail pages".to_string(), 3);
    goal.add_sub_goal("Create shopping cart context and management".to_string(), 4);
    goal.add_sub_goal("Build checkout flow pages".to_string(), 5);
    goal.add_sub_goal("Integrate payment gateway API".to_string(), 6);
    goal.add_sub_goal("Create admin dashboard pages".to_string(), 7);
    goal.add_sub_goal("Add authentication middleware".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a complete e-commerce Next.js application with: \
         1. Product management system (listing, search, filters)\n\
         2. Shopping cart with add/remove/update functionality\n\
         3. User authentication and profile pages\n\
         4. Payment integration endpoints\n\
         5. Order history and tracking\n\
         6. Admin dashboard for managing products and orders\n\
         7. Database models for PostgreSQL or MongoDB\n\
         8. RESTful API endpoints\n\
         Use TypeScript, Tailwind CSS, and modern React patterns."
    );

    println!("📝 Task: Generate E-Commerce Next.js Application\n");
    println!("🎯 Features to Generate:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating e-commerce app...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: SaaS Dashboard App
// ============================================

async fn example_3_saas_dashboard() {
    println!("\n=== Example 3: Generate SaaS Dashboard Next.js App ===\n");

    let mut agent = Agent::new("SaasDashboardGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a SaaS dashboard application with user management".to_string()
    );

    goal.add_criterion("User authentication and authorization".to_string());
    goal.add_criterion("Multi-tenant database structure".to_string());
    goal.add_criterion("Dashboard with analytics and metrics".to_string());
    goal.add_criterion("User and team management pages".to_string());
    goal.add_criterion("Settings and preferences pages".to_string());
    goal.add_criterion("Billing and subscription management".to_string());
    goal.add_criterion("API for data collection and reporting".to_string());

    goal.add_sub_goal("Design multi-tenant database schema".to_string(), 0);
    goal.add_sub_goal("Implement OAuth authentication".to_string(), 1);
    goal.add_sub_goal("Create dashboard with charts and metrics".to_string(), 2);
    goal.add_sub_goal("Build team and user management interfaces".to_string(), 3);
    goal.add_sub_goal("Create settings pages for users and organization".to_string(), 4);
    goal.add_sub_goal("Implement billing API integration".to_string(), 5);
    goal.add_sub_goal("Create analytics and reporting system".to_string(), 6);
    goal.add_sub_goal("Add email notification templates".to_string(), 7);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a complete SaaS dashboard Next.js application with:\n\
         1. Multi-tenant authentication (OAuth + JWT)\n\
         2. Organization and team management\n\
         3. Comprehensive dashboard with charts and analytics\n\
         4. User permission and role management\n\
         5. Billing integration with Stripe\n\
         6. Settings pages for users and teams\n\
         7. Email notifications system\n\
         8. API logging and activity tracking\n\
         9. Dark mode support\n\
         10. Mobile responsive design\n\
         Include TypeScript, Tailwind CSS, Recharts for visualizations, \
         and PostgreSQL database models."
    );

    println!("📝 Task: Generate SaaS Dashboard Application\n");
    println!("🎯 Dashboard Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating SaaS dashboard...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Blog Platform with CMS
// ============================================

async fn example_4_blog_platform() {
    println!("\n=== Example 4: Generate Blog Platform with CMS ===\n");

    let mut agent = Agent::new("BlogCMSGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a comprehensive blog platform with CMS".to_string()
    );

    goal.add_criterion("Blog post management system".to_string());
    goal.add_criterion("Rich text editor with markdown support".to_string());
    goal.add_criterion("Category and tag system".to_string());
    goal.add_criterion("Search and filtering functionality".to_string());
    goal.add_criterion("Comments system with moderation".to_string());
    goal.add_criterion("SEO optimization (meta tags, sitemap)".to_string());
    goal.add_criterion("Author management and permissions".to_string());
    goal.add_criterion("Analytics and engagement tracking".to_string());

    goal.add_sub_goal("Design blog database schema".to_string(), 0);
    goal.add_sub_goal("Create CMS backend API".to_string(), 1);
    goal.add_sub_goal("Build post editor with markdown".to_string(), 2);
    goal.add_sub_goal("Create blog listing and search pages".to_string(), 3);
    goal.add_sub_goal("Build individual post pages with SEO".to_string(), 4);
    goal.add_sub_goal("Implement comments system".to_string(), 5);
    goal.add_sub_goal("Create author profiles and bio".to_string(), 6);
    goal.add_sub_goal("Build admin dashboard for content management".to_string(), 7);
    goal.add_sub_goal("Add analytics tracking and reporting".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a full-featured blog platform with CMS:\n\
         1. Post creation and editing with rich text editor\n\
         2. Markdown support with preview\n\
         3. Category and tag system\n\
         4. Advanced search with filters\n\
         5. Comments system with nested replies\n\
         6. Author profiles with biography\n\
         7. SEO optimization (sitemaps, meta tags, structured data)\n\
         8. Social sharing integration\n\
         9. Email newsletter subscription\n\
         10. Analytics dashboard for authors\n\
         11. Reading time estimates\n\
         12. Related posts suggestions\n\
         Include TypeScript, Tailwind CSS, next-mdx-remote for markdown, \
         and MongoDB/PostgreSQL models."
    );

    println!("📝 Task: Generate Blog Platform with CMS\n");
    println!("🎯 Blog Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating blog platform...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 4 completed!\n");
}

examples/07_python_project_generator.rs (line 120)

async fn example_1_basic_cli_app() {
    println!("=== Example 1: Generate a Basic Python CLI Application ===\n");

    let mut agent = Agent::new("PythonCliGenerator", "ollama::gemma3:latest");

    // Create a goal for generating a Python CLI app
    let mut goal = Goal::new(
        "Generate a Python command-line application with core structure".to_string()
    );

    // Define success criteria
    goal.add_criterion("requirements.txt with dependencies listed".to_string());
    goal.add_criterion("setup.py or pyproject.toml for packaging".to_string());
    goal.add_criterion("Main CLI entry point with argument parsing".to_string());
    goal.add_criterion("Command structure with subcommands".to_string());
    goal.add_criterion("Basic error handling and logging".to_string());
    goal.add_criterion("README.md with usage instructions".to_string());
    goal.add_criterion(".gitignore for Python projects".to_string());

    // Define sub-goals (steps to generate the app)
    goal.add_sub_goal("Analyze Python CLI best practices".to_string(), 0);
    goal.add_sub_goal("Generate project structure and directories".to_string(), 1);
    goal.add_sub_goal("Create requirements.txt with dependencies (Click, Typer, etc)".to_string(), 2);
    goal.add_sub_goal("Generate pyproject.toml or setup.py".to_string(), 3);
    goal.add_sub_goal("Create main CLI module with argument parser".to_string(), 4);
    goal.add_sub_goal("Generate subcommands and command handlers".to_string(), 5);
    goal.add_sub_goal("Create utility modules and helpers".to_string(), 6);
    goal.add_sub_goal("Add logging and error handling".to_string(), 7);
    goal.add_sub_goal("Generate README with installation and usage".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    // Create a task to generate a Python CLI app
    let task = TaskRequest::new(
        "Generate a professional Python command-line application with the following structure:\n\
         1. Modern argument parsing using Click or Typer\n\
         2. Multiple subcommands (e.g., init, run, config, help)\n\
         3. Configuration file support (YAML or JSON)\n\
         4. Logging with different verbosity levels\n\
         5. Error handling and graceful failure messages\n\
         6. Proper project structure with src/ and tests/ directories\n\
         7. pyproject.toml or setup.py for packaging\n\
         8. requirements.txt with dev dependencies\n\
         9. .gitignore for Python\n\
         10. Comprehensive README with examples\n\
         The app should be production-ready and follow Python best practices (PEP 8)."
    );

    println!("📝 Task: Generate a Python CLI Application\n");
    println!("🎯 Success Criteria:");
    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    println!("\n⏳ Agent is generating the Python CLI app...\n");
    let response = agent.run(task).await;

    // Extract and display the output
    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    // Show progress
    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("Status: {:?}", goal.status);

    println!("\n✅ Example 1 completed!\n");
}

// ============================================
// Example 2: Python Web API with FastAPI
// ============================================

async fn example_2_fastapi_web_app() {
    println!("\n=== Example 2: Generate Python FastAPI Web Application ===\n");

    let mut agent = Agent::new("FastApiGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a complete FastAPI web application with database integration".to_string()
    );

    // Success criteria for FastAPI app
    goal.add_criterion("FastAPI application structure with routers".to_string());
    goal.add_criterion("Database models using SQLAlchemy".to_string());
    goal.add_criterion("RESTful API endpoints with CRUD operations".to_string());
    goal.add_criterion("Request/response schemas using Pydantic".to_string());
    goal.add_criterion("Authentication and authorization middleware".to_string());
    goal.add_criterion("Database migrations with Alembic".to_string());
    goal.add_criterion("Configuration management with environment variables".to_string());
    goal.add_criterion("Unit and integration test examples".to_string());
    goal.add_criterion("Docker setup for containerization".to_string());

    // Sub-goals
    goal.add_sub_goal("Design REST API endpoints structure".to_string(), 0);
    goal.add_sub_goal("Create Pydantic models for request/response validation".to_string(), 1);
    goal.add_sub_goal("Set up SQLAlchemy ORM with database models".to_string(), 2);
    goal.add_sub_goal("Implement CRUD routers for resources".to_string(), 3);
    goal.add_sub_goal("Add authentication and JWT tokens".to_string(), 4);
    goal.add_sub_goal("Create Alembic migrations setup".to_string(), 5);
    goal.add_sub_goal("Set up configuration with environment variables".to_string(), 6);
    goal.add_sub_goal("Create test fixtures and example tests".to_string(), 7);
    goal.add_sub_goal("Generate Docker and docker-compose files".to_string(), 8);
    goal.add_sub_goal("Create comprehensive API documentation".to_string(), 9);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a production-ready FastAPI web application with:\n\
         1. Modular project structure with routers for different resources\n\
         2. Pydantic models for request/response validation\n\
         3. SQLAlchemy ORM setup with database models\n\
         4. CRUD operations for users, products, and orders\n\
         5. JWT authentication and authorization middleware\n\
         6. Role-based access control (RBAC)\n\
         7. Alembic database migrations\n\
         8. Environment configuration (.env support)\n\
         9. Error handling with proper HTTP status codes\n\
         10. Logging configuration\n\
         11. Unit tests with pytest\n\
         12. Integration tests with test database\n\
         13. Docker and docker-compose for local development\n\
         14. requirements.txt with all dependencies\n\
         15. Comprehensive API documentation\n\
         Use async/await patterns, follow REST conventions, and include examples."
    );

    println!("📝 Task: Generate FastAPI Web Application\n");
    println!("🎯 FastAPI Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating FastAPI app...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: Python Data Science Project
// ============================================

async fn example_3_data_science_project() {
    println!("\n=== Example 3: Generate Python Data Science Project ===\n");

    let mut agent = Agent::new("DataScienceGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a data science project with ML pipeline and analysis".to_string()
    );

    goal.add_criterion("Project structure following cookiecutter-data-science".to_string());
    goal.add_criterion("Data loading and preprocessing modules".to_string());
    goal.add_criterion("Exploratory data analysis (EDA) notebooks".to_string());
    goal.add_criterion("Feature engineering pipeline".to_string());
    goal.add_criterion("Model training and evaluation".to_string());
    goal.add_criterion("Hyperparameter tuning setup".to_string());
    goal.add_criterion("Model persistence and versioning".to_string());
    goal.add_criterion("Visualization utilities".to_string());
    goal.add_criterion("Unit tests for data pipeline".to_string());

    goal.add_sub_goal("Create cookiecutter-style directory structure".to_string(), 0);
    goal.add_sub_goal("Set up Jupyter notebook for EDA".to_string(), 1);
    goal.add_sub_goal("Create data loading and preprocessing modules".to_string(), 2);
    goal.add_sub_goal("Implement feature engineering pipeline".to_string(), 3);
    goal.add_sub_goal("Set up scikit-learn model training".to_string(), 4);
    goal.add_sub_goal("Create model evaluation and metrics".to_string(), 5);
    goal.add_sub_goal("Implement hyperparameter tuning with GridSearchCV".to_string(), 6);
    goal.add_sub_goal("Add model persistence with joblib/pickle".to_string(), 7);
    goal.add_sub_goal("Create visualization utilities with matplotlib/seaborn".to_string(), 8);
    goal.add_sub_goal("Write tests for data pipeline".to_string(), 9);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a comprehensive Python data science project with:\n\
         1. Proper project structure for data science work\n\
         2. Data loading module supporting CSV, JSON, Parquet\n\
         3. Data preprocessing and validation pipeline\n\
         4. Exploratory Data Analysis (EDA) notebook template\n\
         5. Feature engineering module\n\
         6. Model training with scikit-learn or XGBoost\n\
         7. Cross-validation and evaluation metrics\n\
         8. Hyperparameter tuning with GridSearchCV/RandomSearch\n\
         9. Model persistence and loading utilities\n\
         10. Visualization utilities (matplotlib, seaborn, plotly)\n\
         11. Unit tests for data loading and preprocessing\n\
         12. Configuration management for experiments\n\
         13. Logging for training pipeline\n\
         14. Requirements.txt with ML libraries (pandas, numpy, scikit-learn)\n\
         15. Makefile for common tasks\n\
         16. README with dataset description and results\n\
         Include example workflows and best practices for reproducibility."
    );

    println!("📝 Task: Generate Data Science Project\n");
    println!("🎯 Data Science Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating data science project...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Python Package/Library
// ============================================

async fn example_4_python_library() {
    println!("\n=== Example 4: Generate Python Library/Package ===\n");

    let mut agent = Agent::new("PythonLibraryGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a well-structured Python package ready for distribution".to_string()
    );

    goal.add_criterion("Proper package structure with namespace".to_string());
    goal.add_criterion("setup.py and pyproject.toml for distribution".to_string());
    goal.add_criterion("Comprehensive docstrings and type hints".to_string());
    goal.add_criterion("Unit tests with pytest".to_string());
    goal.add_criterion("Documentation with Sphinx".to_string());
    goal.add_criterion("CI/CD configuration (GitHub Actions)".to_string());
    goal.add_criterion("Version management strategy".to_string());
    goal.add_criterion("Contributing guidelines".to_string());

    goal.add_sub_goal("Create package structure with __init__.py files".to_string(), 0);
    goal.add_sub_goal("Write setup.py and pyproject.toml".to_string(), 1);
    goal.add_sub_goal("Create core modules with type hints".to_string(), 2);
    goal.add_sub_goal("Add comprehensive docstrings".to_string(), 3);
    goal.add_sub_goal("Create test structure with pytest".to_string(), 4);
    goal.add_sub_goal("Set up documentation with Sphinx".to_string(), 5);
    goal.add_sub_goal("Create GitHub Actions workflows".to_string(), 6);
    goal.add_sub_goal("Add CONTRIBUTING.md and CODE_OF_CONDUCT.md".to_string(), 7);
    goal.add_sub_goal("Create MANIFEST.in and manifest files".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a professional Python library/package with:\n\
         1. Standard package structure (src layout)\n\
         2. __init__.py with version and exports\n\
         3. Core modules with complete implementations\n\
         4. Type hints throughout (PEP 484)\n\
         5. Comprehensive docstrings (Google style)\n\
         6. setup.py with metadata\n\
         7. pyproject.toml with build system\n\
         8. MANIFEST.in for package data\n\
         9. Pytest test structure with fixtures\n\
         10. pytest.ini configuration\n\
         11. Sphinx documentation setup\n\
         12. GitHub Actions workflow for CI/CD\n\
         13. Pre-commit hooks configuration\n\
         14. LICENSE (MIT or Apache 2.0)\n\
         15. .gitignore for Python\n\
         16. README.md with installation and usage\n\
         17. CONTRIBUTING.md for contributors\n\
         18. CODE_OF_CONDUCT.md\n\
         19. Changelog/HISTORY.md template\n\
         20. Version management with __version__\n\
         Include examples for public API and best practices for library development."
    );

    println!("📝 Task: Generate Python Library Package\n");
    println!("🎯 Library Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating Python library...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 4 completed!\n");
}

// ============================================
// Example 5: Django Web Application
// ============================================

async fn example_5_django_web_app() {
    println!("\n=== Example 5: Generate Django Web Application ===\n");

    let mut agent = Agent::new("DjangoGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a complete Django web application with admin and authentication".to_string()
    );

    goal.add_criterion("Django project structure with multiple apps".to_string());
    goal.add_criterion("Custom user model implementation".to_string());
    goal.add_criterion("Database models for core features".to_string());
    goal.add_criterion("Admin interface customization".to_string());
    goal.add_criterion("Views and URL routing".to_string());
    goal.add_criterion("Templates with Bootstrap styling".to_string());
    goal.add_criterion("Authentication and permissions".to_string());
    goal.add_criterion("Database migrations".to_string());
    goal.add_criterion("Django REST Framework API".to_string());

    goal.add_sub_goal("Create Django project and app structure".to_string(), 0);
    goal.add_sub_goal("Design and implement custom user model".to_string(), 1);
    goal.add_sub_goal("Create models for core features".to_string(), 2);
    goal.add_sub_goal("Configure admin interface".to_string(), 3);
    goal.add_sub_goal("Create views and templates".to_string(), 4);
    goal.add_sub_goal("Set up URL routing".to_string(), 5);
    goal.add_sub_goal("Implement authentication views".to_string(), 6);
    goal.add_sub_goal("Create Django REST Framework serializers".to_string(), 7);
    goal.add_sub_goal("Set up static files and media handling".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a full-featured Django web application with:\n\
         1. Django project structure with multiple apps\n\
         2. Custom user model extending AbstractBaseUser\n\
         3. Models for main features (e.g., Blog posts, Comments, Categories)\n\
         4. Django ORM relationships (ForeignKey, ManyToMany)\n\
         5. Admin interface with custom actions\n\
         6. Class-based views (ListView, DetailView, CreateView)\n\
         7. Django templates with template inheritance\n\
         8. Bootstrap styling integration\n\
         9. Authentication and login required decorators\n\
         10. Permission-based access control\n\
         11. Database migrations\n\
         12. Forms with validation\n\
         13. Django REST Framework setup\n\
         14. API serializers and viewsets\n\
         15. Pagination and filtering\n\
         16. Settings for dev and production\n\
         17. Environment variable configuration\n\
         18. Logging configuration\n\
         19. Tests with Django TestCase\n\
         20. Static files and media management\n\
         21. Docker setup\n\
         22. Requirements.txt\n\
         Include examples and docstrings following Django conventions."
    );

    println!("📝 Task: Generate Django Web Application\n");
    println!("🎯 Django Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating Django app...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 5 completed!\n");
}

pub fn add_sub_goal(&mut self, description: String, priority: u32)

Adds a sub-goal to the goal.

Arguments

• description - What this sub-goal accomplishes
• priority - Execution order (lower numbers are executed first)

Examples found in repository

examples/05_with_goals.rs (line 43)

async fn example_1_manual_goal() {
    println!("=== Example 1: Manual Goal Creation ===\n");

    // Create an agent
    let mut agent = Agent::new("MealPlanner", "ollama::gemma3:latest");

    // Create a goal manually for a complex task
    let mut goal = Goal::new(
        "Plan a healthy meal prep for the week".to_string()
    );

    // Define what success looks like
    println!("📋 Setting success criteria...");
    goal.add_criterion("7 breakfast recipes selected".to_string());
    goal.add_criterion("7 lunch recipes selected".to_string());
    goal.add_criterion("7 dinner recipes selected".to_string());
    goal.add_criterion("Shopping list created".to_string());
    goal.add_criterion("Prep schedule created".to_string());

    // Break down into steps (sub-goals)
    println!("🎯 Breaking down into sub-goals...\n");
    goal.add_sub_goal("Ask user about dietary preferences".to_string(), 0);
    goal.add_sub_goal("Ask about time available for prep".to_string(), 1);
    goal.add_sub_goal("Suggest breakfast options".to_string(), 2);
    goal.add_sub_goal("Suggest lunch options".to_string(), 3);
    goal.add_sub_goal("Suggest dinner options".to_string(), 4);
    goal.add_sub_goal("Create shopping list".to_string(), 5);
    goal.add_sub_goal("Create prep schedule".to_string(), 6);

    // Start working on the goal
    goal.status = GoalStatus::InProgress;

    // Set the goal on the agent
    agent.set_goal(goal.clone());

    // Create a task aligned with the goal
    let task = TaskRequest::new("I need help with meal planning");

    // Run the agent
    println!("⏳ Agent is working on the meal planning task...\n");
    let _response = agent.run(task).await;

    // Show the goal summary
    println!("\n📊 Goal Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 1 completed!\n");
}

// ============================================
// Example 2: Goal Progress Tracking
// ============================================

async fn example_2_goal_progress_tracking() {
    println!("\n=== Example 2: Goal Progress Tracking ===\n");

    // Create a goal for a project
    let mut goal = Goal::new(
        "Create a project plan for building a mobile app".to_string()
    );

    // Add success criteria
    goal.add_criterion("Project requirements documented".to_string());
    goal.add_criterion("Timeline created with milestones".to_string());
    goal.add_criterion("Resource allocation plan completed".to_string());
    goal.add_criterion("Risk assessment performed".to_string());

    // Add sub-goals
    goal.add_sub_goal("Gather stakeholder requirements".to_string(), 0);
    goal.add_sub_goal("Define project scope".to_string(), 1);
    goal.add_sub_goal("Create development timeline".to_string(), 2);
    goal.add_sub_goal("Allocate resources".to_string(), 3);
    goal.add_sub_goal("Identify risks and mitigation strategies".to_string(), 4);

    goal.status = GoalStatus::InProgress;

    // Simulate progress through the goal
    println!("📈 Tracking goal progress...\n");

    // Complete first sub-goal
    println!("Step 1: Gathering requirements");
    goal.complete_sub_goal(0, Some("Interviewed 5 stakeholders".to_string()));
    goal.mark_criterion_met(0, "Requirements documented".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete second sub-goal
    println!("Step 2: Defining scope");
    goal.complete_sub_goal(1, Some("Scope document created".to_string()));
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete third sub-goal
    println!("Step 3: Creating timeline");
    goal.complete_sub_goal(2, Some("12-month timeline with milestones".to_string()));
    goal.mark_criterion_met(1, "Timeline created".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fourth sub-goal
    println!("Step 4: Allocating resources");
    goal.complete_sub_goal(3, Some("Resource allocation table created".to_string()));
    goal.mark_criterion_met(2, "Resources allocated".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fifth sub-goal
    println!("Step 5: Assessing risks");
    goal.complete_sub_goal(4, Some("Risk register created with 8 identified risks".to_string()));
    goal.mark_criterion_met(3, "Risks identified".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Show final status
    println!("\n📊 Final Goal Status:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: Job Interview Preparation Goal
// ============================================

async fn example_3_interview_preparation() {
    println!("\n=== Example 3: Job Interview Preparation Goal ===\n");

    let mut agent = Agent::new("InterviewCoach", "ollama::gemma3:latest");

    // Create a structured goal for interview prep
    let mut goal = Goal::new(
        "Prepare for a senior software engineer interview at a tech company".to_string()
    );

    // Define success criteria
    println!("🎯 Success criteria:");
    goal.add_criterion("Technical topics reviewed (algorithms, data structures, system design)".to_string());
    goal.add_criterion("Behavioral questions prepared with STAR method examples".to_string());
    goal.add_criterion("Company research completed".to_string());
    goal.add_criterion("Practice mock interview conducted".to_string());
    goal.add_criterion("Questions to ask the interviewer prepared".to_string());

    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    // Define steps
    println!("\n📋 Steps to take:");
    goal.add_sub_goal("Review core algorithms and data structures".to_string(), 0);
    goal.add_sub_goal("Study system design patterns".to_string(), 1);
    goal.add_sub_goal("Prepare STAR method stories from past projects".to_string(), 2);
    goal.add_sub_goal("Research company background and culture".to_string(), 3);
    goal.add_sub_goal("Practice mock interview with a friend".to_string(), 4);
    goal.add_sub_goal("Prepare thoughtful questions about the role".to_string(), 5);

    for sub_goal in &goal.sub_goals {
        println!("  {}. {}", sub_goal.priority + 1, sub_goal.description);
    }

    goal.status = GoalStatus::InProgress;

    // Set goal on agent
    agent.set_goal(goal.clone());

    // Create related task
    let task = TaskRequest::new("Help me prepare for my senior engineer interview");

    println!("\n⏳ Agent is creating interview preparation plan...\n");
    let _response = agent.run(task).await;

    println!("\n📊 Goal Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Goal Analysis from Task Description
// ============================================

fn example_4_goal_analysis() {
    println!("\n=== Example 4: Goal Analysis from Task Description ===\n");

    // Simulate LLM analyzing a task and breaking it down into a goal
    let task_description = "Help me learn Python programming";

    println!("📝 Original task: \"{}\"", task_description);
    println!("\n🔍 LLM analyzing task...\n");

    // This is what the LLM would return
    let analysis = GoalAnalysis {
        main_goal: "Help user learn Python programming from basics to practical skills".to_string(),
        success_criteria: vec![
            "User's current skill level identified".to_string(),
            "Learning path created based on skill level".to_string(),
            "Resources (tutorials, books) provided".to_string(),
            "Practice exercises suggested".to_string(),
            "Study schedule created".to_string(),
        ],
        sub_goals: vec![
            "Ask about current programming experience".to_string(),
            "Identify learning goals (web dev, data science, etc)".to_string(),
            "Create structured learning path".to_string(),
            "Recommend learning resources".to_string(),
            "Suggest practice projects".to_string(),
            "Create study timeline".to_string(),
        ],
    };

    // Convert analysis to a Goal
    let goal = analysis.to_goal();

    println!("✅ Goal created from analysis:\n");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 4 completed!\n");
}

// ============================================
// Example 5: Goal Completion Verification
// ============================================

async fn example_5_goal_completion() {
    println!("\n=== Example 5: Goal Completion Verification ===\n");

    let mut goal = Goal::new("Plan a birthday party".to_string());

    // Set up success criteria
    goal.add_criterion("Guest list created".to_string());
    goal.add_criterion("Venue booked".to_string());
    goal.add_criterion("Food ordered".to_string());
    goal.add_criterion("Decorations purchased".to_string());

    // Set up sub-goals
    goal.add_sub_goal("Ask about guests".to_string(), 0);
    goal.add_sub_goal("Choose and book venue".to_string(), 1);
    goal.add_sub_goal("Order food".to_string(), 2);
    goal.add_sub_goal("Purchase decorations".to_string(), 3);

    goal.status = GoalStatus::InProgress;

    println!("🎉 Birthday party planning task started\n");
    println!("Initial progress: {}%\n", goal.get_progress());

    // Simulate completing tasks
    println!("Working through sub-goals:\n");

    // Task 1
    println!("✓ Contacted 15 friends and family members");
    goal.complete_sub_goal(0, Some("Got 15 confirmations".to_string()));
    goal.mark_criterion_met(0, "List of 15 guests confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 2
    println!("✓ Booked the community center for Saturday");
    goal.complete_sub_goal(1, Some("Community center reserved for 6pm".to_string()));
    goal.mark_criterion_met(1, "Community center booking confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 3
    println!("✓ Ordered pizza and drinks for 15 people");
    goal.complete_sub_goal(2, Some("Pizza and drinks ordered".to_string()));
    goal.mark_criterion_met(2, "Food catering arranged".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 4
    println!("✓ Bought balloons, streamers, and table decorations");
    goal.complete_sub_goal(3, Some("All decorations purchased".to_string()));
    goal.mark_criterion_met(3, "Decorations ready".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Check completion
    if goal.is_successful() {
        println!("🎊 All success criteria met!");
        goal.status = GoalStatus::Completed;
    }

    if goal.all_sub_goals_complete() {
        println!("✅ All sub-goals completed!");
    }

    println!("\nFinal Status:");
    println!("  Status: {:?}", goal.status);
    println!("  All criteria met: {}", goal.is_successful());
    println!("  Progress: {}%\n", goal.get_progress());

    println!("📊 Final Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 5 completed!\n");
}

// ============================================
// Example 6: Complex Multi-Step Project
// ============================================

async fn example_6_complex_project() {
    println!("\n=== Example 6: Complex Multi-Step Project Goal ===\n");

    let mut goal = Goal::new(
        "Launch a new web application product".to_string()
    );

    // Success criteria
    goal.add_criterion("Technical architecture designed and documented".to_string());
    goal.add_criterion("Frontend and backend development completed".to_string());
    goal.add_criterion("Testing completed (unit, integration, E2E)".to_string());
    goal.add_criterion("Deployment pipeline set up".to_string());
    goal.add_criterion("Marketing materials prepared".to_string());
    goal.add_criterion("Team trained on deployment and support".to_string());

    // Sub-goals in order
    goal.add_sub_goal("Define technical requirements and architecture".to_string(), 0);
    goal.add_sub_goal("Set up development environment and CI/CD".to_string(), 1);
    goal.add_sub_goal("Develop backend API endpoints".to_string(), 2);
    goal.add_sub_goal("Build frontend user interface".to_string(), 3);
    goal.add_sub_goal("Write comprehensive test suite".to_string(), 4);
    goal.add_sub_goal("Conduct security audit".to_string(), 5);
    goal.add_sub_goal("Set up monitoring and logging".to_string(), 6);
    goal.add_sub_goal("Deploy to staging environment".to_string(), 7);
    goal.add_sub_goal("Perform final testing and QA".to_string(), 8);
    goal.add_sub_goal("Create deployment documentation".to_string(), 9);
    goal.add_sub_goal("Train support team".to_string(), 10);
    goal.add_sub_goal("Deploy to production".to_string(), 11);

    goal.status = GoalStatus::InProgress;

    println!("🚀 Web Application Product Launch Plan\n");
    println!("Total steps: {}\n", goal.sub_goals.len());

    // Simulate progress
    let completed_steps = vec![
        (0, "Architecture documented with diagrams"),
        (1, "GitHub Actions CI/CD configured"),
        (2, "All 15 API endpoints implemented and tested"),
        (3, "React frontend with all pages completed"),
        (4, "Jest test suite with 85% coverage"),
        (5, "No critical vulnerabilities found"),
        (6, "Prometheus and ELK stack configured"),
        (7, "Successfully deployed to staging"),
        (8, "UAT passed with stakeholders"),
        (9, "Deployment runbook created"),
        (10, "Support team completed training"),
    ];

    for (index, notes) in completed_steps {
        goal.complete_sub_goal(index, Some(notes.to_string()));
    }

    // Mark success criteria as met
    goal.mark_criterion_met(0, "System design document completed".to_string());
    goal.mark_criterion_met(1, "All features implemented and tested".to_string());
    goal.mark_criterion_met(2, "85% test coverage achieved".to_string());
    goal.mark_criterion_met(3, "GitHub Actions and monitoring configured".to_string());
    goal.mark_criterion_met(4, "Marketing deck prepared".to_string());
    goal.mark_criterion_met(5, "Team completed deployment training".to_string());

    println!("📈 Project Progress:\n");
    println!("Overall Progress: {}%\n", goal.get_progress());

    println!("Remaining tasks:");
    if let Some(next) = goal.get_next_sub_goal() {
        println!("  • {}", next.description);
    }

    println!("\n📊 Status Summary:");
    println!("{}", goal.get_summary());

    if goal.get_progress() == 100 {
        println!("\n✅ All sub-goals completed!");
        if goal.is_successful() {
            println!("🎉 All success criteria met!");
            println!("Ready to mark goal as Completed!");
        }
    }

    println!("\n✅ Example 6 completed!\n");
}

examples/06_nextjs_app_generator.rs (line 57)

async fn example_1_basic_nextjs_app() {
    println!("=== Example 1: Generate a Basic Next.js App ===\n");

    // Create an agent that will generate the app
    let mut agent = Agent::new("NextJsGenerator", "ollama::gemma3:latest");

    // Create a goal for generating a Next.js app
    let mut goal = Goal::new(
        "Generate a Next.js web application with essential structure".to_string()
    );

    // Define success criteria
    goal.add_criterion("package.json created with dependencies".to_string());
    goal.add_criterion("next.config.js configuration file generated".to_string());
    goal.add_criterion("pages directory with index and api route created".to_string());
    goal.add_criterion("styles directory with global CSS".to_string());
    goal.add_criterion("README.md with setup instructions".to_string());

    // Define sub-goals (steps to generate the app)
    goal.add_sub_goal("Analyze Next.js requirements and best practices".to_string(), 0);
    goal.add_sub_goal("Generate package.json with required dependencies".to_string(), 1);
    goal.add_sub_goal("Create next.config.js configuration".to_string(), 2);
    goal.add_sub_goal("Generate pages (index.tsx, _app.tsx, _document.tsx)".to_string(), 3);
    goal.add_sub_goal("Create API route examples".to_string(), 4);
    goal.add_sub_goal("Generate styling setup (global.css, utilities)".to_string(), 5);
    goal.add_sub_goal("Create components directory with example components".to_string(), 6);
    goal.add_sub_goal("Generate README with setup and usage instructions".to_string(), 7);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    // Create a task to generate a Next.js app
    let task = TaskRequest::new(
        "Generate a modern Next.js 14 application with TypeScript, Tailwind CSS, and best practices. \
         Include package.json, next.config.js, sample pages, API routes, and components. \
         The app should be production-ready and follow Next.js conventions."
    );

    println!("📝 Task: Generate a Next.js application\n");
    println!("🎯 Success Criteria:");
    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    println!("\n⏳ Agent is generating the Next.js app...\n");
    let response = agent.run(task).await;

    // Extract and display the output
    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    // Show progress
    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("Status: {:?}", goal.status);

    println!("\n✅ Example 1 completed!\n");
}

// ============================================
// Example 2: E-Commerce Next.js App
// ============================================

async fn example_2_ecommerce_app() {
    println!("\n=== Example 2: Generate E-Commerce Next.js App ===\n");

    let mut agent = Agent::new("EcommerceGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a complete e-commerce Next.js application".to_string()
    );

    // Success criteria for e-commerce
    goal.add_criterion("Product listing page with filtering and sorting".to_string());
    goal.add_criterion("Product detail pages with dynamic routes".to_string());
    goal.add_criterion("Shopping cart functionality".to_string());
    goal.add_criterion("User authentication setup".to_string());
    goal.add_criterion("Payment integration structure".to_string());
    goal.add_criterion("Database models and API endpoints".to_string());
    goal.add_criterion("Admin dashboard layout".to_string());

    // Sub-goals
    goal.add_sub_goal("Design database schema for products and orders".to_string(), 0);
    goal.add_sub_goal("Create product API endpoints".to_string(), 1);
    goal.add_sub_goal("Build product listing and search components".to_string(), 2);
    goal.add_sub_goal("Implement product detail pages".to_string(), 3);
    goal.add_sub_goal("Create shopping cart context and management".to_string(), 4);
    goal.add_sub_goal("Build checkout flow pages".to_string(), 5);
    goal.add_sub_goal("Integrate payment gateway API".to_string(), 6);
    goal.add_sub_goal("Create admin dashboard pages".to_string(), 7);
    goal.add_sub_goal("Add authentication middleware".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a complete e-commerce Next.js application with: \
         1. Product management system (listing, search, filters)\n\
         2. Shopping cart with add/remove/update functionality\n\
         3. User authentication and profile pages\n\
         4. Payment integration endpoints\n\
         5. Order history and tracking\n\
         6. Admin dashboard for managing products and orders\n\
         7. Database models for PostgreSQL or MongoDB\n\
         8. RESTful API endpoints\n\
         Use TypeScript, Tailwind CSS, and modern React patterns."
    );

    println!("📝 Task: Generate E-Commerce Next.js Application\n");
    println!("🎯 Features to Generate:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating e-commerce app...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: SaaS Dashboard App
// ============================================

async fn example_3_saas_dashboard() {
    println!("\n=== Example 3: Generate SaaS Dashboard Next.js App ===\n");

    let mut agent = Agent::new("SaasDashboardGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a SaaS dashboard application with user management".to_string()
    );

    goal.add_criterion("User authentication and authorization".to_string());
    goal.add_criterion("Multi-tenant database structure".to_string());
    goal.add_criterion("Dashboard with analytics and metrics".to_string());
    goal.add_criterion("User and team management pages".to_string());
    goal.add_criterion("Settings and preferences pages".to_string());
    goal.add_criterion("Billing and subscription management".to_string());
    goal.add_criterion("API for data collection and reporting".to_string());

    goal.add_sub_goal("Design multi-tenant database schema".to_string(), 0);
    goal.add_sub_goal("Implement OAuth authentication".to_string(), 1);
    goal.add_sub_goal("Create dashboard with charts and metrics".to_string(), 2);
    goal.add_sub_goal("Build team and user management interfaces".to_string(), 3);
    goal.add_sub_goal("Create settings pages for users and organization".to_string(), 4);
    goal.add_sub_goal("Implement billing API integration".to_string(), 5);
    goal.add_sub_goal("Create analytics and reporting system".to_string(), 6);
    goal.add_sub_goal("Add email notification templates".to_string(), 7);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a complete SaaS dashboard Next.js application with:\n\
         1. Multi-tenant authentication (OAuth + JWT)\n\
         2. Organization and team management\n\
         3. Comprehensive dashboard with charts and analytics\n\
         4. User permission and role management\n\
         5. Billing integration with Stripe\n\
         6. Settings pages for users and teams\n\
         7. Email notifications system\n\
         8. API logging and activity tracking\n\
         9. Dark mode support\n\
         10. Mobile responsive design\n\
         Include TypeScript, Tailwind CSS, Recharts for visualizations, \
         and PostgreSQL database models."
    );

    println!("📝 Task: Generate SaaS Dashboard Application\n");
    println!("🎯 Dashboard Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating SaaS dashboard...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Blog Platform with CMS
// ============================================

async fn example_4_blog_platform() {
    println!("\n=== Example 4: Generate Blog Platform with CMS ===\n");

    let mut agent = Agent::new("BlogCMSGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a comprehensive blog platform with CMS".to_string()
    );

    goal.add_criterion("Blog post management system".to_string());
    goal.add_criterion("Rich text editor with markdown support".to_string());
    goal.add_criterion("Category and tag system".to_string());
    goal.add_criterion("Search and filtering functionality".to_string());
    goal.add_criterion("Comments system with moderation".to_string());
    goal.add_criterion("SEO optimization (meta tags, sitemap)".to_string());
    goal.add_criterion("Author management and permissions".to_string());
    goal.add_criterion("Analytics and engagement tracking".to_string());

    goal.add_sub_goal("Design blog database schema".to_string(), 0);
    goal.add_sub_goal("Create CMS backend API".to_string(), 1);
    goal.add_sub_goal("Build post editor with markdown".to_string(), 2);
    goal.add_sub_goal("Create blog listing and search pages".to_string(), 3);
    goal.add_sub_goal("Build individual post pages with SEO".to_string(), 4);
    goal.add_sub_goal("Implement comments system".to_string(), 5);
    goal.add_sub_goal("Create author profiles and bio".to_string(), 6);
    goal.add_sub_goal("Build admin dashboard for content management".to_string(), 7);
    goal.add_sub_goal("Add analytics tracking and reporting".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a full-featured blog platform with CMS:\n\
         1. Post creation and editing with rich text editor\n\
         2. Markdown support with preview\n\
         3. Category and tag system\n\
         4. Advanced search with filters\n\
         5. Comments system with nested replies\n\
         6. Author profiles with biography\n\
         7. SEO optimization (sitemaps, meta tags, structured data)\n\
         8. Social sharing integration\n\
         9. Email newsletter subscription\n\
         10. Analytics dashboard for authors\n\
         11. Reading time estimates\n\
         12. Related posts suggestions\n\
         Include TypeScript, Tailwind CSS, next-mdx-remote for markdown, \
         and MongoDB/PostgreSQL models."
    );

    println!("📝 Task: Generate Blog Platform with CMS\n");
    println!("🎯 Blog Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating blog platform...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 4 completed!\n");
}

examples/07_python_project_generator.rs (line 129)

async fn example_1_basic_cli_app() {
    println!("=== Example 1: Generate a Basic Python CLI Application ===\n");

    let mut agent = Agent::new("PythonCliGenerator", "ollama::gemma3:latest");

    // Create a goal for generating a Python CLI app
    let mut goal = Goal::new(
        "Generate a Python command-line application with core structure".to_string()
    );

    // Define success criteria
    goal.add_criterion("requirements.txt with dependencies listed".to_string());
    goal.add_criterion("setup.py or pyproject.toml for packaging".to_string());
    goal.add_criterion("Main CLI entry point with argument parsing".to_string());
    goal.add_criterion("Command structure with subcommands".to_string());
    goal.add_criterion("Basic error handling and logging".to_string());
    goal.add_criterion("README.md with usage instructions".to_string());
    goal.add_criterion(".gitignore for Python projects".to_string());

    // Define sub-goals (steps to generate the app)
    goal.add_sub_goal("Analyze Python CLI best practices".to_string(), 0);
    goal.add_sub_goal("Generate project structure and directories".to_string(), 1);
    goal.add_sub_goal("Create requirements.txt with dependencies (Click, Typer, etc)".to_string(), 2);
    goal.add_sub_goal("Generate pyproject.toml or setup.py".to_string(), 3);
    goal.add_sub_goal("Create main CLI module with argument parser".to_string(), 4);
    goal.add_sub_goal("Generate subcommands and command handlers".to_string(), 5);
    goal.add_sub_goal("Create utility modules and helpers".to_string(), 6);
    goal.add_sub_goal("Add logging and error handling".to_string(), 7);
    goal.add_sub_goal("Generate README with installation and usage".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    // Create a task to generate a Python CLI app
    let task = TaskRequest::new(
        "Generate a professional Python command-line application with the following structure:\n\
         1. Modern argument parsing using Click or Typer\n\
         2. Multiple subcommands (e.g., init, run, config, help)\n\
         3. Configuration file support (YAML or JSON)\n\
         4. Logging with different verbosity levels\n\
         5. Error handling and graceful failure messages\n\
         6. Proper project structure with src/ and tests/ directories\n\
         7. pyproject.toml or setup.py for packaging\n\
         8. requirements.txt with dev dependencies\n\
         9. .gitignore for Python\n\
         10. Comprehensive README with examples\n\
         The app should be production-ready and follow Python best practices (PEP 8)."
    );

    println!("📝 Task: Generate a Python CLI Application\n");
    println!("🎯 Success Criteria:");
    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    println!("\n⏳ Agent is generating the Python CLI app...\n");
    let response = agent.run(task).await;

    // Extract and display the output
    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    // Show progress
    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("Status: {:?}", goal.status);

    println!("\n✅ Example 1 completed!\n");
}

// ============================================
// Example 2: Python Web API with FastAPI
// ============================================

async fn example_2_fastapi_web_app() {
    println!("\n=== Example 2: Generate Python FastAPI Web Application ===\n");

    let mut agent = Agent::new("FastApiGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a complete FastAPI web application with database integration".to_string()
    );

    // Success criteria for FastAPI app
    goal.add_criterion("FastAPI application structure with routers".to_string());
    goal.add_criterion("Database models using SQLAlchemy".to_string());
    goal.add_criterion("RESTful API endpoints with CRUD operations".to_string());
    goal.add_criterion("Request/response schemas using Pydantic".to_string());
    goal.add_criterion("Authentication and authorization middleware".to_string());
    goal.add_criterion("Database migrations with Alembic".to_string());
    goal.add_criterion("Configuration management with environment variables".to_string());
    goal.add_criterion("Unit and integration test examples".to_string());
    goal.add_criterion("Docker setup for containerization".to_string());

    // Sub-goals
    goal.add_sub_goal("Design REST API endpoints structure".to_string(), 0);
    goal.add_sub_goal("Create Pydantic models for request/response validation".to_string(), 1);
    goal.add_sub_goal("Set up SQLAlchemy ORM with database models".to_string(), 2);
    goal.add_sub_goal("Implement CRUD routers for resources".to_string(), 3);
    goal.add_sub_goal("Add authentication and JWT tokens".to_string(), 4);
    goal.add_sub_goal("Create Alembic migrations setup".to_string(), 5);
    goal.add_sub_goal("Set up configuration with environment variables".to_string(), 6);
    goal.add_sub_goal("Create test fixtures and example tests".to_string(), 7);
    goal.add_sub_goal("Generate Docker and docker-compose files".to_string(), 8);
    goal.add_sub_goal("Create comprehensive API documentation".to_string(), 9);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a production-ready FastAPI web application with:\n\
         1. Modular project structure with routers for different resources\n\
         2. Pydantic models for request/response validation\n\
         3. SQLAlchemy ORM setup with database models\n\
         4. CRUD operations for users, products, and orders\n\
         5. JWT authentication and authorization middleware\n\
         6. Role-based access control (RBAC)\n\
         7. Alembic database migrations\n\
         8. Environment configuration (.env support)\n\
         9. Error handling with proper HTTP status codes\n\
         10. Logging configuration\n\
         11. Unit tests with pytest\n\
         12. Integration tests with test database\n\
         13. Docker and docker-compose for local development\n\
         14. requirements.txt with all dependencies\n\
         15. Comprehensive API documentation\n\
         Use async/await patterns, follow REST conventions, and include examples."
    );

    println!("📝 Task: Generate FastAPI Web Application\n");
    println!("🎯 FastAPI Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating FastAPI app...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: Python Data Science Project
// ============================================

async fn example_3_data_science_project() {
    println!("\n=== Example 3: Generate Python Data Science Project ===\n");

    let mut agent = Agent::new("DataScienceGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a data science project with ML pipeline and analysis".to_string()
    );

    goal.add_criterion("Project structure following cookiecutter-data-science".to_string());
    goal.add_criterion("Data loading and preprocessing modules".to_string());
    goal.add_criterion("Exploratory data analysis (EDA) notebooks".to_string());
    goal.add_criterion("Feature engineering pipeline".to_string());
    goal.add_criterion("Model training and evaluation".to_string());
    goal.add_criterion("Hyperparameter tuning setup".to_string());
    goal.add_criterion("Model persistence and versioning".to_string());
    goal.add_criterion("Visualization utilities".to_string());
    goal.add_criterion("Unit tests for data pipeline".to_string());

    goal.add_sub_goal("Create cookiecutter-style directory structure".to_string(), 0);
    goal.add_sub_goal("Set up Jupyter notebook for EDA".to_string(), 1);
    goal.add_sub_goal("Create data loading and preprocessing modules".to_string(), 2);
    goal.add_sub_goal("Implement feature engineering pipeline".to_string(), 3);
    goal.add_sub_goal("Set up scikit-learn model training".to_string(), 4);
    goal.add_sub_goal("Create model evaluation and metrics".to_string(), 5);
    goal.add_sub_goal("Implement hyperparameter tuning with GridSearchCV".to_string(), 6);
    goal.add_sub_goal("Add model persistence with joblib/pickle".to_string(), 7);
    goal.add_sub_goal("Create visualization utilities with matplotlib/seaborn".to_string(), 8);
    goal.add_sub_goal("Write tests for data pipeline".to_string(), 9);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a comprehensive Python data science project with:\n\
         1. Proper project structure for data science work\n\
         2. Data loading module supporting CSV, JSON, Parquet\n\
         3. Data preprocessing and validation pipeline\n\
         4. Exploratory Data Analysis (EDA) notebook template\n\
         5. Feature engineering module\n\
         6. Model training with scikit-learn or XGBoost\n\
         7. Cross-validation and evaluation metrics\n\
         8. Hyperparameter tuning with GridSearchCV/RandomSearch\n\
         9. Model persistence and loading utilities\n\
         10. Visualization utilities (matplotlib, seaborn, plotly)\n\
         11. Unit tests for data loading and preprocessing\n\
         12. Configuration management for experiments\n\
         13. Logging for training pipeline\n\
         14. Requirements.txt with ML libraries (pandas, numpy, scikit-learn)\n\
         15. Makefile for common tasks\n\
         16. README with dataset description and results\n\
         Include example workflows and best practices for reproducibility."
    );

    println!("📝 Task: Generate Data Science Project\n");
    println!("🎯 Data Science Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating data science project...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Python Package/Library
// ============================================

async fn example_4_python_library() {
    println!("\n=== Example 4: Generate Python Library/Package ===\n");

    let mut agent = Agent::new("PythonLibraryGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a well-structured Python package ready for distribution".to_string()
    );

    goal.add_criterion("Proper package structure with namespace".to_string());
    goal.add_criterion("setup.py and pyproject.toml for distribution".to_string());
    goal.add_criterion("Comprehensive docstrings and type hints".to_string());
    goal.add_criterion("Unit tests with pytest".to_string());
    goal.add_criterion("Documentation with Sphinx".to_string());
    goal.add_criterion("CI/CD configuration (GitHub Actions)".to_string());
    goal.add_criterion("Version management strategy".to_string());
    goal.add_criterion("Contributing guidelines".to_string());

    goal.add_sub_goal("Create package structure with __init__.py files".to_string(), 0);
    goal.add_sub_goal("Write setup.py and pyproject.toml".to_string(), 1);
    goal.add_sub_goal("Create core modules with type hints".to_string(), 2);
    goal.add_sub_goal("Add comprehensive docstrings".to_string(), 3);
    goal.add_sub_goal("Create test structure with pytest".to_string(), 4);
    goal.add_sub_goal("Set up documentation with Sphinx".to_string(), 5);
    goal.add_sub_goal("Create GitHub Actions workflows".to_string(), 6);
    goal.add_sub_goal("Add CONTRIBUTING.md and CODE_OF_CONDUCT.md".to_string(), 7);
    goal.add_sub_goal("Create MANIFEST.in and manifest files".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a professional Python library/package with:\n\
         1. Standard package structure (src layout)\n\
         2. __init__.py with version and exports\n\
         3. Core modules with complete implementations\n\
         4. Type hints throughout (PEP 484)\n\
         5. Comprehensive docstrings (Google style)\n\
         6. setup.py with metadata\n\
         7. pyproject.toml with build system\n\
         8. MANIFEST.in for package data\n\
         9. Pytest test structure with fixtures\n\
         10. pytest.ini configuration\n\
         11. Sphinx documentation setup\n\
         12. GitHub Actions workflow for CI/CD\n\
         13. Pre-commit hooks configuration\n\
         14. LICENSE (MIT or Apache 2.0)\n\
         15. .gitignore for Python\n\
         16. README.md with installation and usage\n\
         17. CONTRIBUTING.md for contributors\n\
         18. CODE_OF_CONDUCT.md\n\
         19. Changelog/HISTORY.md template\n\
         20. Version management with __version__\n\
         Include examples for public API and best practices for library development."
    );

    println!("📝 Task: Generate Python Library Package\n");
    println!("🎯 Library Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating Python library...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 4 completed!\n");
}

// ============================================
// Example 5: Django Web Application
// ============================================

async fn example_5_django_web_app() {
    println!("\n=== Example 5: Generate Django Web Application ===\n");

    let mut agent = Agent::new("DjangoGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a complete Django web application with admin and authentication".to_string()
    );

    goal.add_criterion("Django project structure with multiple apps".to_string());
    goal.add_criterion("Custom user model implementation".to_string());
    goal.add_criterion("Database models for core features".to_string());
    goal.add_criterion("Admin interface customization".to_string());
    goal.add_criterion("Views and URL routing".to_string());
    goal.add_criterion("Templates with Bootstrap styling".to_string());
    goal.add_criterion("Authentication and permissions".to_string());
    goal.add_criterion("Database migrations".to_string());
    goal.add_criterion("Django REST Framework API".to_string());

    goal.add_sub_goal("Create Django project and app structure".to_string(), 0);
    goal.add_sub_goal("Design and implement custom user model".to_string(), 1);
    goal.add_sub_goal("Create models for core features".to_string(), 2);
    goal.add_sub_goal("Configure admin interface".to_string(), 3);
    goal.add_sub_goal("Create views and templates".to_string(), 4);
    goal.add_sub_goal("Set up URL routing".to_string(), 5);
    goal.add_sub_goal("Implement authentication views".to_string(), 6);
    goal.add_sub_goal("Create Django REST Framework serializers".to_string(), 7);
    goal.add_sub_goal("Set up static files and media handling".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a full-featured Django web application with:\n\
         1. Django project structure with multiple apps\n\
         2. Custom user model extending AbstractBaseUser\n\
         3. Models for main features (e.g., Blog posts, Comments, Categories)\n\
         4. Django ORM relationships (ForeignKey, ManyToMany)\n\
         5. Admin interface with custom actions\n\
         6. Class-based views (ListView, DetailView, CreateView)\n\
         7. Django templates with template inheritance\n\
         8. Bootstrap styling integration\n\
         9. Authentication and login required decorators\n\
         10. Permission-based access control\n\
         11. Database migrations\n\
         12. Forms with validation\n\
         13. Django REST Framework setup\n\
         14. API serializers and viewsets\n\
         15. Pagination and filtering\n\
         16. Settings for dev and production\n\
         17. Environment variable configuration\n\
         18. Logging configuration\n\
         19. Tests with Django TestCase\n\
         20. Static files and media management\n\
         21. Docker setup\n\
         22. Requirements.txt\n\
         Include examples and docstrings following Django conventions."
    );

    println!("📝 Task: Generate Django Web Application\n");
    println!("🎯 Django Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating Django app...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 5 completed!\n");
}

pub fn mark_criterion_met(&mut self, index: usize, reason: String)

Marks a success criterion as met.

Arguments

• index - The index of the criterion to mark
• reason - Why the criterion is now met

Examples found in repository

examples/05_with_goals.rs (line 104)

async fn example_2_goal_progress_tracking() {
    println!("\n=== Example 2: Goal Progress Tracking ===\n");

    // Create a goal for a project
    let mut goal = Goal::new(
        "Create a project plan for building a mobile app".to_string()
    );

    // Add success criteria
    goal.add_criterion("Project requirements documented".to_string());
    goal.add_criterion("Timeline created with milestones".to_string());
    goal.add_criterion("Resource allocation plan completed".to_string());
    goal.add_criterion("Risk assessment performed".to_string());

    // Add sub-goals
    goal.add_sub_goal("Gather stakeholder requirements".to_string(), 0);
    goal.add_sub_goal("Define project scope".to_string(), 1);
    goal.add_sub_goal("Create development timeline".to_string(), 2);
    goal.add_sub_goal("Allocate resources".to_string(), 3);
    goal.add_sub_goal("Identify risks and mitigation strategies".to_string(), 4);

    goal.status = GoalStatus::InProgress;

    // Simulate progress through the goal
    println!("📈 Tracking goal progress...\n");

    // Complete first sub-goal
    println!("Step 1: Gathering requirements");
    goal.complete_sub_goal(0, Some("Interviewed 5 stakeholders".to_string()));
    goal.mark_criterion_met(0, "Requirements documented".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete second sub-goal
    println!("Step 2: Defining scope");
    goal.complete_sub_goal(1, Some("Scope document created".to_string()));
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete third sub-goal
    println!("Step 3: Creating timeline");
    goal.complete_sub_goal(2, Some("12-month timeline with milestones".to_string()));
    goal.mark_criterion_met(1, "Timeline created".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fourth sub-goal
    println!("Step 4: Allocating resources");
    goal.complete_sub_goal(3, Some("Resource allocation table created".to_string()));
    goal.mark_criterion_met(2, "Resources allocated".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fifth sub-goal
    println!("Step 5: Assessing risks");
    goal.complete_sub_goal(4, Some("Risk register created with 8 identified risks".to_string()));
    goal.mark_criterion_met(3, "Risks identified".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Show final status
    println!("\n📊 Final Goal Status:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: Job Interview Preparation Goal
// ============================================

async fn example_3_interview_preparation() {
    println!("\n=== Example 3: Job Interview Preparation Goal ===\n");

    let mut agent = Agent::new("InterviewCoach", "ollama::gemma3:latest");

    // Create a structured goal for interview prep
    let mut goal = Goal::new(
        "Prepare for a senior software engineer interview at a tech company".to_string()
    );

    // Define success criteria
    println!("🎯 Success criteria:");
    goal.add_criterion("Technical topics reviewed (algorithms, data structures, system design)".to_string());
    goal.add_criterion("Behavioral questions prepared with STAR method examples".to_string());
    goal.add_criterion("Company research completed".to_string());
    goal.add_criterion("Practice mock interview conducted".to_string());
    goal.add_criterion("Questions to ask the interviewer prepared".to_string());

    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    // Define steps
    println!("\n📋 Steps to take:");
    goal.add_sub_goal("Review core algorithms and data structures".to_string(), 0);
    goal.add_sub_goal("Study system design patterns".to_string(), 1);
    goal.add_sub_goal("Prepare STAR method stories from past projects".to_string(), 2);
    goal.add_sub_goal("Research company background and culture".to_string(), 3);
    goal.add_sub_goal("Practice mock interview with a friend".to_string(), 4);
    goal.add_sub_goal("Prepare thoughtful questions about the role".to_string(), 5);

    for sub_goal in &goal.sub_goals {
        println!("  {}. {}", sub_goal.priority + 1, sub_goal.description);
    }

    goal.status = GoalStatus::InProgress;

    // Set goal on agent
    agent.set_goal(goal.clone());

    // Create related task
    let task = TaskRequest::new("Help me prepare for my senior engineer interview");

    println!("\n⏳ Agent is creating interview preparation plan...\n");
    let _response = agent.run(task).await;

    println!("\n📊 Goal Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Goal Analysis from Task Description
// ============================================

fn example_4_goal_analysis() {
    println!("\n=== Example 4: Goal Analysis from Task Description ===\n");

    // Simulate LLM analyzing a task and breaking it down into a goal
    let task_description = "Help me learn Python programming";

    println!("📝 Original task: \"{}\"", task_description);
    println!("\n🔍 LLM analyzing task...\n");

    // This is what the LLM would return
    let analysis = GoalAnalysis {
        main_goal: "Help user learn Python programming from basics to practical skills".to_string(),
        success_criteria: vec![
            "User's current skill level identified".to_string(),
            "Learning path created based on skill level".to_string(),
            "Resources (tutorials, books) provided".to_string(),
            "Practice exercises suggested".to_string(),
            "Study schedule created".to_string(),
        ],
        sub_goals: vec![
            "Ask about current programming experience".to_string(),
            "Identify learning goals (web dev, data science, etc)".to_string(),
            "Create structured learning path".to_string(),
            "Recommend learning resources".to_string(),
            "Suggest practice projects".to_string(),
            "Create study timeline".to_string(),
        ],
    };

    // Convert analysis to a Goal
    let goal = analysis.to_goal();

    println!("✅ Goal created from analysis:\n");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 4 completed!\n");
}

// ============================================
// Example 5: Goal Completion Verification
// ============================================

async fn example_5_goal_completion() {
    println!("\n=== Example 5: Goal Completion Verification ===\n");

    let mut goal = Goal::new("Plan a birthday party".to_string());

    // Set up success criteria
    goal.add_criterion("Guest list created".to_string());
    goal.add_criterion("Venue booked".to_string());
    goal.add_criterion("Food ordered".to_string());
    goal.add_criterion("Decorations purchased".to_string());

    // Set up sub-goals
    goal.add_sub_goal("Ask about guests".to_string(), 0);
    goal.add_sub_goal("Choose and book venue".to_string(), 1);
    goal.add_sub_goal("Order food".to_string(), 2);
    goal.add_sub_goal("Purchase decorations".to_string(), 3);

    goal.status = GoalStatus::InProgress;

    println!("🎉 Birthday party planning task started\n");
    println!("Initial progress: {}%\n", goal.get_progress());

    // Simulate completing tasks
    println!("Working through sub-goals:\n");

    // Task 1
    println!("✓ Contacted 15 friends and family members");
    goal.complete_sub_goal(0, Some("Got 15 confirmations".to_string()));
    goal.mark_criterion_met(0, "List of 15 guests confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 2
    println!("✓ Booked the community center for Saturday");
    goal.complete_sub_goal(1, Some("Community center reserved for 6pm".to_string()));
    goal.mark_criterion_met(1, "Community center booking confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 3
    println!("✓ Ordered pizza and drinks for 15 people");
    goal.complete_sub_goal(2, Some("Pizza and drinks ordered".to_string()));
    goal.mark_criterion_met(2, "Food catering arranged".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 4
    println!("✓ Bought balloons, streamers, and table decorations");
    goal.complete_sub_goal(3, Some("All decorations purchased".to_string()));
    goal.mark_criterion_met(3, "Decorations ready".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Check completion
    if goal.is_successful() {
        println!("🎊 All success criteria met!");
        goal.status = GoalStatus::Completed;
    }

    if goal.all_sub_goals_complete() {
        println!("✅ All sub-goals completed!");
    }

    println!("\nFinal Status:");
    println!("  Status: {:?}", goal.status);
    println!("  All criteria met: {}", goal.is_successful());
    println!("  Progress: {}%\n", goal.get_progress());

    println!("📊 Final Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 5 completed!\n");
}

// ============================================
// Example 6: Complex Multi-Step Project
// ============================================

async fn example_6_complex_project() {
    println!("\n=== Example 6: Complex Multi-Step Project Goal ===\n");

    let mut goal = Goal::new(
        "Launch a new web application product".to_string()
    );

    // Success criteria
    goal.add_criterion("Technical architecture designed and documented".to_string());
    goal.add_criterion("Frontend and backend development completed".to_string());
    goal.add_criterion("Testing completed (unit, integration, E2E)".to_string());
    goal.add_criterion("Deployment pipeline set up".to_string());
    goal.add_criterion("Marketing materials prepared".to_string());
    goal.add_criterion("Team trained on deployment and support".to_string());

    // Sub-goals in order
    goal.add_sub_goal("Define technical requirements and architecture".to_string(), 0);
    goal.add_sub_goal("Set up development environment and CI/CD".to_string(), 1);
    goal.add_sub_goal("Develop backend API endpoints".to_string(), 2);
    goal.add_sub_goal("Build frontend user interface".to_string(), 3);
    goal.add_sub_goal("Write comprehensive test suite".to_string(), 4);
    goal.add_sub_goal("Conduct security audit".to_string(), 5);
    goal.add_sub_goal("Set up monitoring and logging".to_string(), 6);
    goal.add_sub_goal("Deploy to staging environment".to_string(), 7);
    goal.add_sub_goal("Perform final testing and QA".to_string(), 8);
    goal.add_sub_goal("Create deployment documentation".to_string(), 9);
    goal.add_sub_goal("Train support team".to_string(), 10);
    goal.add_sub_goal("Deploy to production".to_string(), 11);

    goal.status = GoalStatus::InProgress;

    println!("🚀 Web Application Product Launch Plan\n");
    println!("Total steps: {}\n", goal.sub_goals.len());

    // Simulate progress
    let completed_steps = vec![
        (0, "Architecture documented with diagrams"),
        (1, "GitHub Actions CI/CD configured"),
        (2, "All 15 API endpoints implemented and tested"),
        (3, "React frontend with all pages completed"),
        (4, "Jest test suite with 85% coverage"),
        (5, "No critical vulnerabilities found"),
        (6, "Prometheus and ELK stack configured"),
        (7, "Successfully deployed to staging"),
        (8, "UAT passed with stakeholders"),
        (9, "Deployment runbook created"),
        (10, "Support team completed training"),
    ];

    for (index, notes) in completed_steps {
        goal.complete_sub_goal(index, Some(notes.to_string()));
    }

    // Mark success criteria as met
    goal.mark_criterion_met(0, "System design document completed".to_string());
    goal.mark_criterion_met(1, "All features implemented and tested".to_string());
    goal.mark_criterion_met(2, "85% test coverage achieved".to_string());
    goal.mark_criterion_met(3, "GitHub Actions and monitoring configured".to_string());
    goal.mark_criterion_met(4, "Marketing deck prepared".to_string());
    goal.mark_criterion_met(5, "Team completed deployment training".to_string());

    println!("📈 Project Progress:\n");
    println!("Overall Progress: {}%\n", goal.get_progress());

    println!("Remaining tasks:");
    if let Some(next) = goal.get_next_sub_goal() {
        println!("  • {}", next.description);
    }

    println!("\n📊 Status Summary:");
    println!("{}", goal.get_summary());

    if goal.get_progress() == 100 {
        println!("\n✅ All sub-goals completed!");
        if goal.is_successful() {
            println!("🎉 All success criteria met!");
            println!("Ready to mark goal as Completed!");
        }
    }

    println!("\n✅ Example 6 completed!\n");
}

pub fn complete_sub_goal(&mut self, index: usize, notes: Option<String>)

Marks a sub-goal as complete.

Arguments

• index - The index of the sub-goal to complete
• notes - Optional notes about the completion

Examples found in repository

examples/05_with_goals.rs (line 103)

async fn example_2_goal_progress_tracking() {
    println!("\n=== Example 2: Goal Progress Tracking ===\n");

    // Create a goal for a project
    let mut goal = Goal::new(
        "Create a project plan for building a mobile app".to_string()
    );

    // Add success criteria
    goal.add_criterion("Project requirements documented".to_string());
    goal.add_criterion("Timeline created with milestones".to_string());
    goal.add_criterion("Resource allocation plan completed".to_string());
    goal.add_criterion("Risk assessment performed".to_string());

    // Add sub-goals
    goal.add_sub_goal("Gather stakeholder requirements".to_string(), 0);
    goal.add_sub_goal("Define project scope".to_string(), 1);
    goal.add_sub_goal("Create development timeline".to_string(), 2);
    goal.add_sub_goal("Allocate resources".to_string(), 3);
    goal.add_sub_goal("Identify risks and mitigation strategies".to_string(), 4);

    goal.status = GoalStatus::InProgress;

    // Simulate progress through the goal
    println!("📈 Tracking goal progress...\n");

    // Complete first sub-goal
    println!("Step 1: Gathering requirements");
    goal.complete_sub_goal(0, Some("Interviewed 5 stakeholders".to_string()));
    goal.mark_criterion_met(0, "Requirements documented".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete second sub-goal
    println!("Step 2: Defining scope");
    goal.complete_sub_goal(1, Some("Scope document created".to_string()));
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete third sub-goal
    println!("Step 3: Creating timeline");
    goal.complete_sub_goal(2, Some("12-month timeline with milestones".to_string()));
    goal.mark_criterion_met(1, "Timeline created".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fourth sub-goal
    println!("Step 4: Allocating resources");
    goal.complete_sub_goal(3, Some("Resource allocation table created".to_string()));
    goal.mark_criterion_met(2, "Resources allocated".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fifth sub-goal
    println!("Step 5: Assessing risks");
    goal.complete_sub_goal(4, Some("Risk register created with 8 identified risks".to_string()));
    goal.mark_criterion_met(3, "Risks identified".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Show final status
    println!("\n📊 Final Goal Status:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: Job Interview Preparation Goal
// ============================================

async fn example_3_interview_preparation() {
    println!("\n=== Example 3: Job Interview Preparation Goal ===\n");

    let mut agent = Agent::new("InterviewCoach", "ollama::gemma3:latest");

    // Create a structured goal for interview prep
    let mut goal = Goal::new(
        "Prepare for a senior software engineer interview at a tech company".to_string()
    );

    // Define success criteria
    println!("🎯 Success criteria:");
    goal.add_criterion("Technical topics reviewed (algorithms, data structures, system design)".to_string());
    goal.add_criterion("Behavioral questions prepared with STAR method examples".to_string());
    goal.add_criterion("Company research completed".to_string());
    goal.add_criterion("Practice mock interview conducted".to_string());
    goal.add_criterion("Questions to ask the interviewer prepared".to_string());

    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    // Define steps
    println!("\n📋 Steps to take:");
    goal.add_sub_goal("Review core algorithms and data structures".to_string(), 0);
    goal.add_sub_goal("Study system design patterns".to_string(), 1);
    goal.add_sub_goal("Prepare STAR method stories from past projects".to_string(), 2);
    goal.add_sub_goal("Research company background and culture".to_string(), 3);
    goal.add_sub_goal("Practice mock interview with a friend".to_string(), 4);
    goal.add_sub_goal("Prepare thoughtful questions about the role".to_string(), 5);

    for sub_goal in &goal.sub_goals {
        println!("  {}. {}", sub_goal.priority + 1, sub_goal.description);
    }

    goal.status = GoalStatus::InProgress;

    // Set goal on agent
    agent.set_goal(goal.clone());

    // Create related task
    let task = TaskRequest::new("Help me prepare for my senior engineer interview");

    println!("\n⏳ Agent is creating interview preparation plan...\n");
    let _response = agent.run(task).await;

    println!("\n📊 Goal Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Goal Analysis from Task Description
// ============================================

fn example_4_goal_analysis() {
    println!("\n=== Example 4: Goal Analysis from Task Description ===\n");

    // Simulate LLM analyzing a task and breaking it down into a goal
    let task_description = "Help me learn Python programming";

    println!("📝 Original task: \"{}\"", task_description);
    println!("\n🔍 LLM analyzing task...\n");

    // This is what the LLM would return
    let analysis = GoalAnalysis {
        main_goal: "Help user learn Python programming from basics to practical skills".to_string(),
        success_criteria: vec![
            "User's current skill level identified".to_string(),
            "Learning path created based on skill level".to_string(),
            "Resources (tutorials, books) provided".to_string(),
            "Practice exercises suggested".to_string(),
            "Study schedule created".to_string(),
        ],
        sub_goals: vec![
            "Ask about current programming experience".to_string(),
            "Identify learning goals (web dev, data science, etc)".to_string(),
            "Create structured learning path".to_string(),
            "Recommend learning resources".to_string(),
            "Suggest practice projects".to_string(),
            "Create study timeline".to_string(),
        ],
    };

    // Convert analysis to a Goal
    let goal = analysis.to_goal();

    println!("✅ Goal created from analysis:\n");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 4 completed!\n");
}

// ============================================
// Example 5: Goal Completion Verification
// ============================================

async fn example_5_goal_completion() {
    println!("\n=== Example 5: Goal Completion Verification ===\n");

    let mut goal = Goal::new("Plan a birthday party".to_string());

    // Set up success criteria
    goal.add_criterion("Guest list created".to_string());
    goal.add_criterion("Venue booked".to_string());
    goal.add_criterion("Food ordered".to_string());
    goal.add_criterion("Decorations purchased".to_string());

    // Set up sub-goals
    goal.add_sub_goal("Ask about guests".to_string(), 0);
    goal.add_sub_goal("Choose and book venue".to_string(), 1);
    goal.add_sub_goal("Order food".to_string(), 2);
    goal.add_sub_goal("Purchase decorations".to_string(), 3);

    goal.status = GoalStatus::InProgress;

    println!("🎉 Birthday party planning task started\n");
    println!("Initial progress: {}%\n", goal.get_progress());

    // Simulate completing tasks
    println!("Working through sub-goals:\n");

    // Task 1
    println!("✓ Contacted 15 friends and family members");
    goal.complete_sub_goal(0, Some("Got 15 confirmations".to_string()));
    goal.mark_criterion_met(0, "List of 15 guests confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 2
    println!("✓ Booked the community center for Saturday");
    goal.complete_sub_goal(1, Some("Community center reserved for 6pm".to_string()));
    goal.mark_criterion_met(1, "Community center booking confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 3
    println!("✓ Ordered pizza and drinks for 15 people");
    goal.complete_sub_goal(2, Some("Pizza and drinks ordered".to_string()));
    goal.mark_criterion_met(2, "Food catering arranged".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 4
    println!("✓ Bought balloons, streamers, and table decorations");
    goal.complete_sub_goal(3, Some("All decorations purchased".to_string()));
    goal.mark_criterion_met(3, "Decorations ready".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Check completion
    if goal.is_successful() {
        println!("🎊 All success criteria met!");
        goal.status = GoalStatus::Completed;
    }

    if goal.all_sub_goals_complete() {
        println!("✅ All sub-goals completed!");
    }

    println!("\nFinal Status:");
    println!("  Status: {:?}", goal.status);
    println!("  All criteria met: {}", goal.is_successful());
    println!("  Progress: {}%\n", goal.get_progress());

    println!("📊 Final Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 5 completed!\n");
}

// ============================================
// Example 6: Complex Multi-Step Project
// ============================================

async fn example_6_complex_project() {
    println!("\n=== Example 6: Complex Multi-Step Project Goal ===\n");

    let mut goal = Goal::new(
        "Launch a new web application product".to_string()
    );

    // Success criteria
    goal.add_criterion("Technical architecture designed and documented".to_string());
    goal.add_criterion("Frontend and backend development completed".to_string());
    goal.add_criterion("Testing completed (unit, integration, E2E)".to_string());
    goal.add_criterion("Deployment pipeline set up".to_string());
    goal.add_criterion("Marketing materials prepared".to_string());
    goal.add_criterion("Team trained on deployment and support".to_string());

    // Sub-goals in order
    goal.add_sub_goal("Define technical requirements and architecture".to_string(), 0);
    goal.add_sub_goal("Set up development environment and CI/CD".to_string(), 1);
    goal.add_sub_goal("Develop backend API endpoints".to_string(), 2);
    goal.add_sub_goal("Build frontend user interface".to_string(), 3);
    goal.add_sub_goal("Write comprehensive test suite".to_string(), 4);
    goal.add_sub_goal("Conduct security audit".to_string(), 5);
    goal.add_sub_goal("Set up monitoring and logging".to_string(), 6);
    goal.add_sub_goal("Deploy to staging environment".to_string(), 7);
    goal.add_sub_goal("Perform final testing and QA".to_string(), 8);
    goal.add_sub_goal("Create deployment documentation".to_string(), 9);
    goal.add_sub_goal("Train support team".to_string(), 10);
    goal.add_sub_goal("Deploy to production".to_string(), 11);

    goal.status = GoalStatus::InProgress;

    println!("🚀 Web Application Product Launch Plan\n");
    println!("Total steps: {}\n", goal.sub_goals.len());

    // Simulate progress
    let completed_steps = vec![
        (0, "Architecture documented with diagrams"),
        (1, "GitHub Actions CI/CD configured"),
        (2, "All 15 API endpoints implemented and tested"),
        (3, "React frontend with all pages completed"),
        (4, "Jest test suite with 85% coverage"),
        (5, "No critical vulnerabilities found"),
        (6, "Prometheus and ELK stack configured"),
        (7, "Successfully deployed to staging"),
        (8, "UAT passed with stakeholders"),
        (9, "Deployment runbook created"),
        (10, "Support team completed training"),
    ];

    for (index, notes) in completed_steps {
        goal.complete_sub_goal(index, Some(notes.to_string()));
    }

    // Mark success criteria as met
    goal.mark_criterion_met(0, "System design document completed".to_string());
    goal.mark_criterion_met(1, "All features implemented and tested".to_string());
    goal.mark_criterion_met(2, "85% test coverage achieved".to_string());
    goal.mark_criterion_met(3, "GitHub Actions and monitoring configured".to_string());
    goal.mark_criterion_met(4, "Marketing deck prepared".to_string());
    goal.mark_criterion_met(5, "Team completed deployment training".to_string());

    println!("📈 Project Progress:\n");
    println!("Overall Progress: {}%\n", goal.get_progress());

    println!("Remaining tasks:");
    if let Some(next) = goal.get_next_sub_goal() {
        println!("  • {}", next.description);
    }

    println!("\n📊 Status Summary:");
    println!("{}", goal.get_summary());

    if goal.get_progress() == 100 {
        println!("\n✅ All sub-goals completed!");
        if goal.is_successful() {
            println!("🎉 All success criteria met!");
            println!("Ready to mark goal as Completed!");
        }
    }

    println!("\n✅ Example 6 completed!\n");
}

pub fn is_successful(&self) -> bool

Checks if all success criteria are met.

Returns

true if all criteria are met, false otherwise

Examples found in repository

examples/05_with_goals.rs (line 289)

async fn example_5_goal_completion() {
    println!("\n=== Example 5: Goal Completion Verification ===\n");

    let mut goal = Goal::new("Plan a birthday party".to_string());

    // Set up success criteria
    goal.add_criterion("Guest list created".to_string());
    goal.add_criterion("Venue booked".to_string());
    goal.add_criterion("Food ordered".to_string());
    goal.add_criterion("Decorations purchased".to_string());

    // Set up sub-goals
    goal.add_sub_goal("Ask about guests".to_string(), 0);
    goal.add_sub_goal("Choose and book venue".to_string(), 1);
    goal.add_sub_goal("Order food".to_string(), 2);
    goal.add_sub_goal("Purchase decorations".to_string(), 3);

    goal.status = GoalStatus::InProgress;

    println!("🎉 Birthday party planning task started\n");
    println!("Initial progress: {}%\n", goal.get_progress());

    // Simulate completing tasks
    println!("Working through sub-goals:\n");

    // Task 1
    println!("✓ Contacted 15 friends and family members");
    goal.complete_sub_goal(0, Some("Got 15 confirmations".to_string()));
    goal.mark_criterion_met(0, "List of 15 guests confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 2
    println!("✓ Booked the community center for Saturday");
    goal.complete_sub_goal(1, Some("Community center reserved for 6pm".to_string()));
    goal.mark_criterion_met(1, "Community center booking confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 3
    println!("✓ Ordered pizza and drinks for 15 people");
    goal.complete_sub_goal(2, Some("Pizza and drinks ordered".to_string()));
    goal.mark_criterion_met(2, "Food catering arranged".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 4
    println!("✓ Bought balloons, streamers, and table decorations");
    goal.complete_sub_goal(3, Some("All decorations purchased".to_string()));
    goal.mark_criterion_met(3, "Decorations ready".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Check completion
    if goal.is_successful() {
        println!("🎊 All success criteria met!");
        goal.status = GoalStatus::Completed;
    }

    if goal.all_sub_goals_complete() {
        println!("✅ All sub-goals completed!");
    }

    println!("\nFinal Status:");
    println!("  Status: {:?}", goal.status);
    println!("  All criteria met: {}", goal.is_successful());
    println!("  Progress: {}%\n", goal.get_progress());

    println!("📊 Final Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 5 completed!\n");
}

// ============================================
// Example 6: Complex Multi-Step Project
// ============================================

async fn example_6_complex_project() {
    println!("\n=== Example 6: Complex Multi-Step Project Goal ===\n");

    let mut goal = Goal::new(
        "Launch a new web application product".to_string()
    );

    // Success criteria
    goal.add_criterion("Technical architecture designed and documented".to_string());
    goal.add_criterion("Frontend and backend development completed".to_string());
    goal.add_criterion("Testing completed (unit, integration, E2E)".to_string());
    goal.add_criterion("Deployment pipeline set up".to_string());
    goal.add_criterion("Marketing materials prepared".to_string());
    goal.add_criterion("Team trained on deployment and support".to_string());

    // Sub-goals in order
    goal.add_sub_goal("Define technical requirements and architecture".to_string(), 0);
    goal.add_sub_goal("Set up development environment and CI/CD".to_string(), 1);
    goal.add_sub_goal("Develop backend API endpoints".to_string(), 2);
    goal.add_sub_goal("Build frontend user interface".to_string(), 3);
    goal.add_sub_goal("Write comprehensive test suite".to_string(), 4);
    goal.add_sub_goal("Conduct security audit".to_string(), 5);
    goal.add_sub_goal("Set up monitoring and logging".to_string(), 6);
    goal.add_sub_goal("Deploy to staging environment".to_string(), 7);
    goal.add_sub_goal("Perform final testing and QA".to_string(), 8);
    goal.add_sub_goal("Create deployment documentation".to_string(), 9);
    goal.add_sub_goal("Train support team".to_string(), 10);
    goal.add_sub_goal("Deploy to production".to_string(), 11);

    goal.status = GoalStatus::InProgress;

    println!("🚀 Web Application Product Launch Plan\n");
    println!("Total steps: {}\n", goal.sub_goals.len());

    // Simulate progress
    let completed_steps = vec![
        (0, "Architecture documented with diagrams"),
        (1, "GitHub Actions CI/CD configured"),
        (2, "All 15 API endpoints implemented and tested"),
        (3, "React frontend with all pages completed"),
        (4, "Jest test suite with 85% coverage"),
        (5, "No critical vulnerabilities found"),
        (6, "Prometheus and ELK stack configured"),
        (7, "Successfully deployed to staging"),
        (8, "UAT passed with stakeholders"),
        (9, "Deployment runbook created"),
        (10, "Support team completed training"),
    ];

    for (index, notes) in completed_steps {
        goal.complete_sub_goal(index, Some(notes.to_string()));
    }

    // Mark success criteria as met
    goal.mark_criterion_met(0, "System design document completed".to_string());
    goal.mark_criterion_met(1, "All features implemented and tested".to_string());
    goal.mark_criterion_met(2, "85% test coverage achieved".to_string());
    goal.mark_criterion_met(3, "GitHub Actions and monitoring configured".to_string());
    goal.mark_criterion_met(4, "Marketing deck prepared".to_string());
    goal.mark_criterion_met(5, "Team completed deployment training".to_string());

    println!("📈 Project Progress:\n");
    println!("Overall Progress: {}%\n", goal.get_progress());

    println!("Remaining tasks:");
    if let Some(next) = goal.get_next_sub_goal() {
        println!("  • {}", next.description);
    }

    println!("\n📊 Status Summary:");
    println!("{}", goal.get_summary());

    if goal.get_progress() == 100 {
        println!("\n✅ All sub-goals completed!");
        if goal.is_successful() {
            println!("🎉 All success criteria met!");
            println!("Ready to mark goal as Completed!");
        }
    }

    println!("\n✅ Example 6 completed!\n");
}

pub fn all_sub_goals_complete(&self) -> bool

Checks if all sub-goals are complete.

Returns

true if all sub-goals are complete, false otherwise

Examples found in repository

examples/05_with_goals.rs (line 294)

async fn example_5_goal_completion() {
    println!("\n=== Example 5: Goal Completion Verification ===\n");

    let mut goal = Goal::new("Plan a birthday party".to_string());

    // Set up success criteria
    goal.add_criterion("Guest list created".to_string());
    goal.add_criterion("Venue booked".to_string());
    goal.add_criterion("Food ordered".to_string());
    goal.add_criterion("Decorations purchased".to_string());

    // Set up sub-goals
    goal.add_sub_goal("Ask about guests".to_string(), 0);
    goal.add_sub_goal("Choose and book venue".to_string(), 1);
    goal.add_sub_goal("Order food".to_string(), 2);
    goal.add_sub_goal("Purchase decorations".to_string(), 3);

    goal.status = GoalStatus::InProgress;

    println!("🎉 Birthday party planning task started\n");
    println!("Initial progress: {}%\n", goal.get_progress());

    // Simulate completing tasks
    println!("Working through sub-goals:\n");

    // Task 1
    println!("✓ Contacted 15 friends and family members");
    goal.complete_sub_goal(0, Some("Got 15 confirmations".to_string()));
    goal.mark_criterion_met(0, "List of 15 guests confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 2
    println!("✓ Booked the community center for Saturday");
    goal.complete_sub_goal(1, Some("Community center reserved for 6pm".to_string()));
    goal.mark_criterion_met(1, "Community center booking confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 3
    println!("✓ Ordered pizza and drinks for 15 people");
    goal.complete_sub_goal(2, Some("Pizza and drinks ordered".to_string()));
    goal.mark_criterion_met(2, "Food catering arranged".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 4
    println!("✓ Bought balloons, streamers, and table decorations");
    goal.complete_sub_goal(3, Some("All decorations purchased".to_string()));
    goal.mark_criterion_met(3, "Decorations ready".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Check completion
    if goal.is_successful() {
        println!("🎊 All success criteria met!");
        goal.status = GoalStatus::Completed;
    }

    if goal.all_sub_goals_complete() {
        println!("✅ All sub-goals completed!");
    }

    println!("\nFinal Status:");
    println!("  Status: {:?}", goal.status);
    println!("  All criteria met: {}", goal.is_successful());
    println!("  Progress: {}%\n", goal.get_progress());

    println!("📊 Final Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 5 completed!\n");
}

pub fn get_next_sub_goal(&self) -> Option<&SubGoal>

Returns the next sub-goal to work on.

Returns the incomplete sub-goal with the lowest priority number.

Returns

The next sub-goal to work on, or None if all are complete

Examples found in repository

examples/05_with_goals.rs (line 378)

async fn example_6_complex_project() {
    println!("\n=== Example 6: Complex Multi-Step Project Goal ===\n");

    let mut goal = Goal::new(
        "Launch a new web application product".to_string()
    );

    // Success criteria
    goal.add_criterion("Technical architecture designed and documented".to_string());
    goal.add_criterion("Frontend and backend development completed".to_string());
    goal.add_criterion("Testing completed (unit, integration, E2E)".to_string());
    goal.add_criterion("Deployment pipeline set up".to_string());
    goal.add_criterion("Marketing materials prepared".to_string());
    goal.add_criterion("Team trained on deployment and support".to_string());

    // Sub-goals in order
    goal.add_sub_goal("Define technical requirements and architecture".to_string(), 0);
    goal.add_sub_goal("Set up development environment and CI/CD".to_string(), 1);
    goal.add_sub_goal("Develop backend API endpoints".to_string(), 2);
    goal.add_sub_goal("Build frontend user interface".to_string(), 3);
    goal.add_sub_goal("Write comprehensive test suite".to_string(), 4);
    goal.add_sub_goal("Conduct security audit".to_string(), 5);
    goal.add_sub_goal("Set up monitoring and logging".to_string(), 6);
    goal.add_sub_goal("Deploy to staging environment".to_string(), 7);
    goal.add_sub_goal("Perform final testing and QA".to_string(), 8);
    goal.add_sub_goal("Create deployment documentation".to_string(), 9);
    goal.add_sub_goal("Train support team".to_string(), 10);
    goal.add_sub_goal("Deploy to production".to_string(), 11);

    goal.status = GoalStatus::InProgress;

    println!("🚀 Web Application Product Launch Plan\n");
    println!("Total steps: {}\n", goal.sub_goals.len());

    // Simulate progress
    let completed_steps = vec![
        (0, "Architecture documented with diagrams"),
        (1, "GitHub Actions CI/CD configured"),
        (2, "All 15 API endpoints implemented and tested"),
        (3, "React frontend with all pages completed"),
        (4, "Jest test suite with 85% coverage"),
        (5, "No critical vulnerabilities found"),
        (6, "Prometheus and ELK stack configured"),
        (7, "Successfully deployed to staging"),
        (8, "UAT passed with stakeholders"),
        (9, "Deployment runbook created"),
        (10, "Support team completed training"),
    ];

    for (index, notes) in completed_steps {
        goal.complete_sub_goal(index, Some(notes.to_string()));
    }

    // Mark success criteria as met
    goal.mark_criterion_met(0, "System design document completed".to_string());
    goal.mark_criterion_met(1, "All features implemented and tested".to_string());
    goal.mark_criterion_met(2, "85% test coverage achieved".to_string());
    goal.mark_criterion_met(3, "GitHub Actions and monitoring configured".to_string());
    goal.mark_criterion_met(4, "Marketing deck prepared".to_string());
    goal.mark_criterion_met(5, "Team completed deployment training".to_string());

    println!("📈 Project Progress:\n");
    println!("Overall Progress: {}%\n", goal.get_progress());

    println!("Remaining tasks:");
    if let Some(next) = goal.get_next_sub_goal() {
        println!("  • {}", next.description);
    }

    println!("\n📊 Status Summary:");
    println!("{}", goal.get_summary());

    if goal.get_progress() == 100 {
        println!("\n✅ All sub-goals completed!");
        if goal.is_successful() {
            println!("🎉 All success criteria met!");
            println!("Ready to mark goal as Completed!");
        }
    }

    println!("\n✅ Example 6 completed!\n");
}

pub fn get_progress(&self) -> u32

Calculates the progress percentage.

Returns

Progress as a percentage (0-100)

Examples found in repository

examples/05_with_goals.rs (line 105)

async fn example_2_goal_progress_tracking() {
    println!("\n=== Example 2: Goal Progress Tracking ===\n");

    // Create a goal for a project
    let mut goal = Goal::new(
        "Create a project plan for building a mobile app".to_string()
    );

    // Add success criteria
    goal.add_criterion("Project requirements documented".to_string());
    goal.add_criterion("Timeline created with milestones".to_string());
    goal.add_criterion("Resource allocation plan completed".to_string());
    goal.add_criterion("Risk assessment performed".to_string());

    // Add sub-goals
    goal.add_sub_goal("Gather stakeholder requirements".to_string(), 0);
    goal.add_sub_goal("Define project scope".to_string(), 1);
    goal.add_sub_goal("Create development timeline".to_string(), 2);
    goal.add_sub_goal("Allocate resources".to_string(), 3);
    goal.add_sub_goal("Identify risks and mitigation strategies".to_string(), 4);

    goal.status = GoalStatus::InProgress;

    // Simulate progress through the goal
    println!("📈 Tracking goal progress...\n");

    // Complete first sub-goal
    println!("Step 1: Gathering requirements");
    goal.complete_sub_goal(0, Some("Interviewed 5 stakeholders".to_string()));
    goal.mark_criterion_met(0, "Requirements documented".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete second sub-goal
    println!("Step 2: Defining scope");
    goal.complete_sub_goal(1, Some("Scope document created".to_string()));
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete third sub-goal
    println!("Step 3: Creating timeline");
    goal.complete_sub_goal(2, Some("12-month timeline with milestones".to_string()));
    goal.mark_criterion_met(1, "Timeline created".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fourth sub-goal
    println!("Step 4: Allocating resources");
    goal.complete_sub_goal(3, Some("Resource allocation table created".to_string()));
    goal.mark_criterion_met(2, "Resources allocated".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fifth sub-goal
    println!("Step 5: Assessing risks");
    goal.complete_sub_goal(4, Some("Risk register created with 8 identified risks".to_string()));
    goal.mark_criterion_met(3, "Risks identified".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Show final status
    println!("\n📊 Final Goal Status:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: Job Interview Preparation Goal
// ============================================

async fn example_3_interview_preparation() {
    println!("\n=== Example 3: Job Interview Preparation Goal ===\n");

    let mut agent = Agent::new("InterviewCoach", "ollama::gemma3:latest");

    // Create a structured goal for interview prep
    let mut goal = Goal::new(
        "Prepare for a senior software engineer interview at a tech company".to_string()
    );

    // Define success criteria
    println!("🎯 Success criteria:");
    goal.add_criterion("Technical topics reviewed (algorithms, data structures, system design)".to_string());
    goal.add_criterion("Behavioral questions prepared with STAR method examples".to_string());
    goal.add_criterion("Company research completed".to_string());
    goal.add_criterion("Practice mock interview conducted".to_string());
    goal.add_criterion("Questions to ask the interviewer prepared".to_string());

    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    // Define steps
    println!("\n📋 Steps to take:");
    goal.add_sub_goal("Review core algorithms and data structures".to_string(), 0);
    goal.add_sub_goal("Study system design patterns".to_string(), 1);
    goal.add_sub_goal("Prepare STAR method stories from past projects".to_string(), 2);
    goal.add_sub_goal("Research company background and culture".to_string(), 3);
    goal.add_sub_goal("Practice mock interview with a friend".to_string(), 4);
    goal.add_sub_goal("Prepare thoughtful questions about the role".to_string(), 5);

    for sub_goal in &goal.sub_goals {
        println!("  {}. {}", sub_goal.priority + 1, sub_goal.description);
    }

    goal.status = GoalStatus::InProgress;

    // Set goal on agent
    agent.set_goal(goal.clone());

    // Create related task
    let task = TaskRequest::new("Help me prepare for my senior engineer interview");

    println!("\n⏳ Agent is creating interview preparation plan...\n");
    let _response = agent.run(task).await;

    println!("\n📊 Goal Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Goal Analysis from Task Description
// ============================================

fn example_4_goal_analysis() {
    println!("\n=== Example 4: Goal Analysis from Task Description ===\n");

    // Simulate LLM analyzing a task and breaking it down into a goal
    let task_description = "Help me learn Python programming";

    println!("📝 Original task: \"{}\"", task_description);
    println!("\n🔍 LLM analyzing task...\n");

    // This is what the LLM would return
    let analysis = GoalAnalysis {
        main_goal: "Help user learn Python programming from basics to practical skills".to_string(),
        success_criteria: vec![
            "User's current skill level identified".to_string(),
            "Learning path created based on skill level".to_string(),
            "Resources (tutorials, books) provided".to_string(),
            "Practice exercises suggested".to_string(),
            "Study schedule created".to_string(),
        ],
        sub_goals: vec![
            "Ask about current programming experience".to_string(),
            "Identify learning goals (web dev, data science, etc)".to_string(),
            "Create structured learning path".to_string(),
            "Recommend learning resources".to_string(),
            "Suggest practice projects".to_string(),
            "Create study timeline".to_string(),
        ],
    };

    // Convert analysis to a Goal
    let goal = analysis.to_goal();

    println!("✅ Goal created from analysis:\n");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 4 completed!\n");
}

// ============================================
// Example 5: Goal Completion Verification
// ============================================

async fn example_5_goal_completion() {
    println!("\n=== Example 5: Goal Completion Verification ===\n");

    let mut goal = Goal::new("Plan a birthday party".to_string());

    // Set up success criteria
    goal.add_criterion("Guest list created".to_string());
    goal.add_criterion("Venue booked".to_string());
    goal.add_criterion("Food ordered".to_string());
    goal.add_criterion("Decorations purchased".to_string());

    // Set up sub-goals
    goal.add_sub_goal("Ask about guests".to_string(), 0);
    goal.add_sub_goal("Choose and book venue".to_string(), 1);
    goal.add_sub_goal("Order food".to_string(), 2);
    goal.add_sub_goal("Purchase decorations".to_string(), 3);

    goal.status = GoalStatus::InProgress;

    println!("🎉 Birthday party planning task started\n");
    println!("Initial progress: {}%\n", goal.get_progress());

    // Simulate completing tasks
    println!("Working through sub-goals:\n");

    // Task 1
    println!("✓ Contacted 15 friends and family members");
    goal.complete_sub_goal(0, Some("Got 15 confirmations".to_string()));
    goal.mark_criterion_met(0, "List of 15 guests confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 2
    println!("✓ Booked the community center for Saturday");
    goal.complete_sub_goal(1, Some("Community center reserved for 6pm".to_string()));
    goal.mark_criterion_met(1, "Community center booking confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 3
    println!("✓ Ordered pizza and drinks for 15 people");
    goal.complete_sub_goal(2, Some("Pizza and drinks ordered".to_string()));
    goal.mark_criterion_met(2, "Food catering arranged".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 4
    println!("✓ Bought balloons, streamers, and table decorations");
    goal.complete_sub_goal(3, Some("All decorations purchased".to_string()));
    goal.mark_criterion_met(3, "Decorations ready".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Check completion
    if goal.is_successful() {
        println!("🎊 All success criteria met!");
        goal.status = GoalStatus::Completed;
    }

    if goal.all_sub_goals_complete() {
        println!("✅ All sub-goals completed!");
    }

    println!("\nFinal Status:");
    println!("  Status: {:?}", goal.status);
    println!("  All criteria met: {}", goal.is_successful());
    println!("  Progress: {}%\n", goal.get_progress());

    println!("📊 Final Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 5 completed!\n");
}

// ============================================
// Example 6: Complex Multi-Step Project
// ============================================

async fn example_6_complex_project() {
    println!("\n=== Example 6: Complex Multi-Step Project Goal ===\n");

    let mut goal = Goal::new(
        "Launch a new web application product".to_string()
    );

    // Success criteria
    goal.add_criterion("Technical architecture designed and documented".to_string());
    goal.add_criterion("Frontend and backend development completed".to_string());
    goal.add_criterion("Testing completed (unit, integration, E2E)".to_string());
    goal.add_criterion("Deployment pipeline set up".to_string());
    goal.add_criterion("Marketing materials prepared".to_string());
    goal.add_criterion("Team trained on deployment and support".to_string());

    // Sub-goals in order
    goal.add_sub_goal("Define technical requirements and architecture".to_string(), 0);
    goal.add_sub_goal("Set up development environment and CI/CD".to_string(), 1);
    goal.add_sub_goal("Develop backend API endpoints".to_string(), 2);
    goal.add_sub_goal("Build frontend user interface".to_string(), 3);
    goal.add_sub_goal("Write comprehensive test suite".to_string(), 4);
    goal.add_sub_goal("Conduct security audit".to_string(), 5);
    goal.add_sub_goal("Set up monitoring and logging".to_string(), 6);
    goal.add_sub_goal("Deploy to staging environment".to_string(), 7);
    goal.add_sub_goal("Perform final testing and QA".to_string(), 8);
    goal.add_sub_goal("Create deployment documentation".to_string(), 9);
    goal.add_sub_goal("Train support team".to_string(), 10);
    goal.add_sub_goal("Deploy to production".to_string(), 11);

    goal.status = GoalStatus::InProgress;

    println!("🚀 Web Application Product Launch Plan\n");
    println!("Total steps: {}\n", goal.sub_goals.len());

    // Simulate progress
    let completed_steps = vec![
        (0, "Architecture documented with diagrams"),
        (1, "GitHub Actions CI/CD configured"),
        (2, "All 15 API endpoints implemented and tested"),
        (3, "React frontend with all pages completed"),
        (4, "Jest test suite with 85% coverage"),
        (5, "No critical vulnerabilities found"),
        (6, "Prometheus and ELK stack configured"),
        (7, "Successfully deployed to staging"),
        (8, "UAT passed with stakeholders"),
        (9, "Deployment runbook created"),
        (10, "Support team completed training"),
    ];

    for (index, notes) in completed_steps {
        goal.complete_sub_goal(index, Some(notes.to_string()));
    }

    // Mark success criteria as met
    goal.mark_criterion_met(0, "System design document completed".to_string());
    goal.mark_criterion_met(1, "All features implemented and tested".to_string());
    goal.mark_criterion_met(2, "85% test coverage achieved".to_string());
    goal.mark_criterion_met(3, "GitHub Actions and monitoring configured".to_string());
    goal.mark_criterion_met(4, "Marketing deck prepared".to_string());
    goal.mark_criterion_met(5, "Team completed deployment training".to_string());

    println!("📈 Project Progress:\n");
    println!("Overall Progress: {}%\n", goal.get_progress());

    println!("Remaining tasks:");
    if let Some(next) = goal.get_next_sub_goal() {
        println!("  • {}", next.description);
    }

    println!("\n📊 Status Summary:");
    println!("{}", goal.get_summary());

    if goal.get_progress() == 100 {
        println!("\n✅ All sub-goals completed!");
        if goal.is_successful() {
            println!("🎉 All success criteria met!");
            println!("Ready to mark goal as Completed!");
        }
    }

    println!("\n✅ Example 6 completed!\n");
}

examples/06_nextjs_app_generator.rs (line 91)

async fn example_1_basic_nextjs_app() {
    println!("=== Example 1: Generate a Basic Next.js App ===\n");

    // Create an agent that will generate the app
    let mut agent = Agent::new("NextJsGenerator", "ollama::gemma3:latest");

    // Create a goal for generating a Next.js app
    let mut goal = Goal::new(
        "Generate a Next.js web application with essential structure".to_string()
    );

    // Define success criteria
    goal.add_criterion("package.json created with dependencies".to_string());
    goal.add_criterion("next.config.js configuration file generated".to_string());
    goal.add_criterion("pages directory with index and api route created".to_string());
    goal.add_criterion("styles directory with global CSS".to_string());
    goal.add_criterion("README.md with setup instructions".to_string());

    // Define sub-goals (steps to generate the app)
    goal.add_sub_goal("Analyze Next.js requirements and best practices".to_string(), 0);
    goal.add_sub_goal("Generate package.json with required dependencies".to_string(), 1);
    goal.add_sub_goal("Create next.config.js configuration".to_string(), 2);
    goal.add_sub_goal("Generate pages (index.tsx, _app.tsx, _document.tsx)".to_string(), 3);
    goal.add_sub_goal("Create API route examples".to_string(), 4);
    goal.add_sub_goal("Generate styling setup (global.css, utilities)".to_string(), 5);
    goal.add_sub_goal("Create components directory with example components".to_string(), 6);
    goal.add_sub_goal("Generate README with setup and usage instructions".to_string(), 7);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    // Create a task to generate a Next.js app
    let task = TaskRequest::new(
        "Generate a modern Next.js 14 application with TypeScript, Tailwind CSS, and best practices. \
         Include package.json, next.config.js, sample pages, API routes, and components. \
         The app should be production-ready and follow Next.js conventions."
    );

    println!("📝 Task: Generate a Next.js application\n");
    println!("🎯 Success Criteria:");
    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    println!("\n⏳ Agent is generating the Next.js app...\n");
    let response = agent.run(task).await;

    // Extract and display the output
    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    // Show progress
    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("Status: {:?}", goal.status);

    println!("\n✅ Example 1 completed!\n");
}

// ============================================
// Example 2: E-Commerce Next.js App
// ============================================

async fn example_2_ecommerce_app() {
    println!("\n=== Example 2: Generate E-Commerce Next.js App ===\n");

    let mut agent = Agent::new("EcommerceGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a complete e-commerce Next.js application".to_string()
    );

    // Success criteria for e-commerce
    goal.add_criterion("Product listing page with filtering and sorting".to_string());
    goal.add_criterion("Product detail pages with dynamic routes".to_string());
    goal.add_criterion("Shopping cart functionality".to_string());
    goal.add_criterion("User authentication setup".to_string());
    goal.add_criterion("Payment integration structure".to_string());
    goal.add_criterion("Database models and API endpoints".to_string());
    goal.add_criterion("Admin dashboard layout".to_string());

    // Sub-goals
    goal.add_sub_goal("Design database schema for products and orders".to_string(), 0);
    goal.add_sub_goal("Create product API endpoints".to_string(), 1);
    goal.add_sub_goal("Build product listing and search components".to_string(), 2);
    goal.add_sub_goal("Implement product detail pages".to_string(), 3);
    goal.add_sub_goal("Create shopping cart context and management".to_string(), 4);
    goal.add_sub_goal("Build checkout flow pages".to_string(), 5);
    goal.add_sub_goal("Integrate payment gateway API".to_string(), 6);
    goal.add_sub_goal("Create admin dashboard pages".to_string(), 7);
    goal.add_sub_goal("Add authentication middleware".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a complete e-commerce Next.js application with: \
         1. Product management system (listing, search, filters)\n\
         2. Shopping cart with add/remove/update functionality\n\
         3. User authentication and profile pages\n\
         4. Payment integration endpoints\n\
         5. Order history and tracking\n\
         6. Admin dashboard for managing products and orders\n\
         7. Database models for PostgreSQL or MongoDB\n\
         8. RESTful API endpoints\n\
         Use TypeScript, Tailwind CSS, and modern React patterns."
    );

    println!("📝 Task: Generate E-Commerce Next.js Application\n");
    println!("🎯 Features to Generate:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating e-commerce app...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: SaaS Dashboard App
// ============================================

async fn example_3_saas_dashboard() {
    println!("\n=== Example 3: Generate SaaS Dashboard Next.js App ===\n");

    let mut agent = Agent::new("SaasDashboardGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a SaaS dashboard application with user management".to_string()
    );

    goal.add_criterion("User authentication and authorization".to_string());
    goal.add_criterion("Multi-tenant database structure".to_string());
    goal.add_criterion("Dashboard with analytics and metrics".to_string());
    goal.add_criterion("User and team management pages".to_string());
    goal.add_criterion("Settings and preferences pages".to_string());
    goal.add_criterion("Billing and subscription management".to_string());
    goal.add_criterion("API for data collection and reporting".to_string());

    goal.add_sub_goal("Design multi-tenant database schema".to_string(), 0);
    goal.add_sub_goal("Implement OAuth authentication".to_string(), 1);
    goal.add_sub_goal("Create dashboard with charts and metrics".to_string(), 2);
    goal.add_sub_goal("Build team and user management interfaces".to_string(), 3);
    goal.add_sub_goal("Create settings pages for users and organization".to_string(), 4);
    goal.add_sub_goal("Implement billing API integration".to_string(), 5);
    goal.add_sub_goal("Create analytics and reporting system".to_string(), 6);
    goal.add_sub_goal("Add email notification templates".to_string(), 7);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a complete SaaS dashboard Next.js application with:\n\
         1. Multi-tenant authentication (OAuth + JWT)\n\
         2. Organization and team management\n\
         3. Comprehensive dashboard with charts and analytics\n\
         4. User permission and role management\n\
         5. Billing integration with Stripe\n\
         6. Settings pages for users and teams\n\
         7. Email notifications system\n\
         8. API logging and activity tracking\n\
         9. Dark mode support\n\
         10. Mobile responsive design\n\
         Include TypeScript, Tailwind CSS, Recharts for visualizations, \
         and PostgreSQL database models."
    );

    println!("📝 Task: Generate SaaS Dashboard Application\n");
    println!("🎯 Dashboard Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating SaaS dashboard...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Blog Platform with CMS
// ============================================

async fn example_4_blog_platform() {
    println!("\n=== Example 4: Generate Blog Platform with CMS ===\n");

    let mut agent = Agent::new("BlogCMSGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a comprehensive blog platform with CMS".to_string()
    );

    goal.add_criterion("Blog post management system".to_string());
    goal.add_criterion("Rich text editor with markdown support".to_string());
    goal.add_criterion("Category and tag system".to_string());
    goal.add_criterion("Search and filtering functionality".to_string());
    goal.add_criterion("Comments system with moderation".to_string());
    goal.add_criterion("SEO optimization (meta tags, sitemap)".to_string());
    goal.add_criterion("Author management and permissions".to_string());
    goal.add_criterion("Analytics and engagement tracking".to_string());

    goal.add_sub_goal("Design blog database schema".to_string(), 0);
    goal.add_sub_goal("Create CMS backend API".to_string(), 1);
    goal.add_sub_goal("Build post editor with markdown".to_string(), 2);
    goal.add_sub_goal("Create blog listing and search pages".to_string(), 3);
    goal.add_sub_goal("Build individual post pages with SEO".to_string(), 4);
    goal.add_sub_goal("Implement comments system".to_string(), 5);
    goal.add_sub_goal("Create author profiles and bio".to_string(), 6);
    goal.add_sub_goal("Build admin dashboard for content management".to_string(), 7);
    goal.add_sub_goal("Add analytics tracking and reporting".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a full-featured blog platform with CMS:\n\
         1. Post creation and editing with rich text editor\n\
         2. Markdown support with preview\n\
         3. Category and tag system\n\
         4. Advanced search with filters\n\
         5. Comments system with nested replies\n\
         6. Author profiles with biography\n\
         7. SEO optimization (sitemaps, meta tags, structured data)\n\
         8. Social sharing integration\n\
         9. Email newsletter subscription\n\
         10. Analytics dashboard for authors\n\
         11. Reading time estimates\n\
         12. Related posts suggestions\n\
         Include TypeScript, Tailwind CSS, next-mdx-remote for markdown, \
         and MongoDB/PostgreSQL models."
    );

    println!("📝 Task: Generate Blog Platform with CMS\n");
    println!("🎯 Blog Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating blog platform...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 4 completed!\n");
}

examples/07_python_project_generator.rs (line 173)

async fn example_1_basic_cli_app() {
    println!("=== Example 1: Generate a Basic Python CLI Application ===\n");

    let mut agent = Agent::new("PythonCliGenerator", "ollama::gemma3:latest");

    // Create a goal for generating a Python CLI app
    let mut goal = Goal::new(
        "Generate a Python command-line application with core structure".to_string()
    );

    // Define success criteria
    goal.add_criterion("requirements.txt with dependencies listed".to_string());
    goal.add_criterion("setup.py or pyproject.toml for packaging".to_string());
    goal.add_criterion("Main CLI entry point with argument parsing".to_string());
    goal.add_criterion("Command structure with subcommands".to_string());
    goal.add_criterion("Basic error handling and logging".to_string());
    goal.add_criterion("README.md with usage instructions".to_string());
    goal.add_criterion(".gitignore for Python projects".to_string());

    // Define sub-goals (steps to generate the app)
    goal.add_sub_goal("Analyze Python CLI best practices".to_string(), 0);
    goal.add_sub_goal("Generate project structure and directories".to_string(), 1);
    goal.add_sub_goal("Create requirements.txt with dependencies (Click, Typer, etc)".to_string(), 2);
    goal.add_sub_goal("Generate pyproject.toml or setup.py".to_string(), 3);
    goal.add_sub_goal("Create main CLI module with argument parser".to_string(), 4);
    goal.add_sub_goal("Generate subcommands and command handlers".to_string(), 5);
    goal.add_sub_goal("Create utility modules and helpers".to_string(), 6);
    goal.add_sub_goal("Add logging and error handling".to_string(), 7);
    goal.add_sub_goal("Generate README with installation and usage".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    // Create a task to generate a Python CLI app
    let task = TaskRequest::new(
        "Generate a professional Python command-line application with the following structure:\n\
         1. Modern argument parsing using Click or Typer\n\
         2. Multiple subcommands (e.g., init, run, config, help)\n\
         3. Configuration file support (YAML or JSON)\n\
         4. Logging with different verbosity levels\n\
         5. Error handling and graceful failure messages\n\
         6. Proper project structure with src/ and tests/ directories\n\
         7. pyproject.toml or setup.py for packaging\n\
         8. requirements.txt with dev dependencies\n\
         9. .gitignore for Python\n\
         10. Comprehensive README with examples\n\
         The app should be production-ready and follow Python best practices (PEP 8)."
    );

    println!("📝 Task: Generate a Python CLI Application\n");
    println!("🎯 Success Criteria:");
    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    println!("\n⏳ Agent is generating the Python CLI app...\n");
    let response = agent.run(task).await;

    // Extract and display the output
    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    // Show progress
    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("Status: {:?}", goal.status);

    println!("\n✅ Example 1 completed!\n");
}

// ============================================
// Example 2: Python Web API with FastAPI
// ============================================

async fn example_2_fastapi_web_app() {
    println!("\n=== Example 2: Generate Python FastAPI Web Application ===\n");

    let mut agent = Agent::new("FastApiGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a complete FastAPI web application with database integration".to_string()
    );

    // Success criteria for FastAPI app
    goal.add_criterion("FastAPI application structure with routers".to_string());
    goal.add_criterion("Database models using SQLAlchemy".to_string());
    goal.add_criterion("RESTful API endpoints with CRUD operations".to_string());
    goal.add_criterion("Request/response schemas using Pydantic".to_string());
    goal.add_criterion("Authentication and authorization middleware".to_string());
    goal.add_criterion("Database migrations with Alembic".to_string());
    goal.add_criterion("Configuration management with environment variables".to_string());
    goal.add_criterion("Unit and integration test examples".to_string());
    goal.add_criterion("Docker setup for containerization".to_string());

    // Sub-goals
    goal.add_sub_goal("Design REST API endpoints structure".to_string(), 0);
    goal.add_sub_goal("Create Pydantic models for request/response validation".to_string(), 1);
    goal.add_sub_goal("Set up SQLAlchemy ORM with database models".to_string(), 2);
    goal.add_sub_goal("Implement CRUD routers for resources".to_string(), 3);
    goal.add_sub_goal("Add authentication and JWT tokens".to_string(), 4);
    goal.add_sub_goal("Create Alembic migrations setup".to_string(), 5);
    goal.add_sub_goal("Set up configuration with environment variables".to_string(), 6);
    goal.add_sub_goal("Create test fixtures and example tests".to_string(), 7);
    goal.add_sub_goal("Generate Docker and docker-compose files".to_string(), 8);
    goal.add_sub_goal("Create comprehensive API documentation".to_string(), 9);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a production-ready FastAPI web application with:\n\
         1. Modular project structure with routers for different resources\n\
         2. Pydantic models for request/response validation\n\
         3. SQLAlchemy ORM setup with database models\n\
         4. CRUD operations for users, products, and orders\n\
         5. JWT authentication and authorization middleware\n\
         6. Role-based access control (RBAC)\n\
         7. Alembic database migrations\n\
         8. Environment configuration (.env support)\n\
         9. Error handling with proper HTTP status codes\n\
         10. Logging configuration\n\
         11. Unit tests with pytest\n\
         12. Integration tests with test database\n\
         13. Docker and docker-compose for local development\n\
         14. requirements.txt with all dependencies\n\
         15. Comprehensive API documentation\n\
         Use async/await patterns, follow REST conventions, and include examples."
    );

    println!("📝 Task: Generate FastAPI Web Application\n");
    println!("🎯 FastAPI Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating FastAPI app...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: Python Data Science Project
// ============================================

async fn example_3_data_science_project() {
    println!("\n=== Example 3: Generate Python Data Science Project ===\n");

    let mut agent = Agent::new("DataScienceGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a data science project with ML pipeline and analysis".to_string()
    );

    goal.add_criterion("Project structure following cookiecutter-data-science".to_string());
    goal.add_criterion("Data loading and preprocessing modules".to_string());
    goal.add_criterion("Exploratory data analysis (EDA) notebooks".to_string());
    goal.add_criterion("Feature engineering pipeline".to_string());
    goal.add_criterion("Model training and evaluation".to_string());
    goal.add_criterion("Hyperparameter tuning setup".to_string());
    goal.add_criterion("Model persistence and versioning".to_string());
    goal.add_criterion("Visualization utilities".to_string());
    goal.add_criterion("Unit tests for data pipeline".to_string());

    goal.add_sub_goal("Create cookiecutter-style directory structure".to_string(), 0);
    goal.add_sub_goal("Set up Jupyter notebook for EDA".to_string(), 1);
    goal.add_sub_goal("Create data loading and preprocessing modules".to_string(), 2);
    goal.add_sub_goal("Implement feature engineering pipeline".to_string(), 3);
    goal.add_sub_goal("Set up scikit-learn model training".to_string(), 4);
    goal.add_sub_goal("Create model evaluation and metrics".to_string(), 5);
    goal.add_sub_goal("Implement hyperparameter tuning with GridSearchCV".to_string(), 6);
    goal.add_sub_goal("Add model persistence with joblib/pickle".to_string(), 7);
    goal.add_sub_goal("Create visualization utilities with matplotlib/seaborn".to_string(), 8);
    goal.add_sub_goal("Write tests for data pipeline".to_string(), 9);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a comprehensive Python data science project with:\n\
         1. Proper project structure for data science work\n\
         2. Data loading module supporting CSV, JSON, Parquet\n\
         3. Data preprocessing and validation pipeline\n\
         4. Exploratory Data Analysis (EDA) notebook template\n\
         5. Feature engineering module\n\
         6. Model training with scikit-learn or XGBoost\n\
         7. Cross-validation and evaluation metrics\n\
         8. Hyperparameter tuning with GridSearchCV/RandomSearch\n\
         9. Model persistence and loading utilities\n\
         10. Visualization utilities (matplotlib, seaborn, plotly)\n\
         11. Unit tests for data loading and preprocessing\n\
         12. Configuration management for experiments\n\
         13. Logging for training pipeline\n\
         14. Requirements.txt with ML libraries (pandas, numpy, scikit-learn)\n\
         15. Makefile for common tasks\n\
         16. README with dataset description and results\n\
         Include example workflows and best practices for reproducibility."
    );

    println!("📝 Task: Generate Data Science Project\n");
    println!("🎯 Data Science Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating data science project...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Python Package/Library
// ============================================

async fn example_4_python_library() {
    println!("\n=== Example 4: Generate Python Library/Package ===\n");

    let mut agent = Agent::new("PythonLibraryGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a well-structured Python package ready for distribution".to_string()
    );

    goal.add_criterion("Proper package structure with namespace".to_string());
    goal.add_criterion("setup.py and pyproject.toml for distribution".to_string());
    goal.add_criterion("Comprehensive docstrings and type hints".to_string());
    goal.add_criterion("Unit tests with pytest".to_string());
    goal.add_criterion("Documentation with Sphinx".to_string());
    goal.add_criterion("CI/CD configuration (GitHub Actions)".to_string());
    goal.add_criterion("Version management strategy".to_string());
    goal.add_criterion("Contributing guidelines".to_string());

    goal.add_sub_goal("Create package structure with __init__.py files".to_string(), 0);
    goal.add_sub_goal("Write setup.py and pyproject.toml".to_string(), 1);
    goal.add_sub_goal("Create core modules with type hints".to_string(), 2);
    goal.add_sub_goal("Add comprehensive docstrings".to_string(), 3);
    goal.add_sub_goal("Create test structure with pytest".to_string(), 4);
    goal.add_sub_goal("Set up documentation with Sphinx".to_string(), 5);
    goal.add_sub_goal("Create GitHub Actions workflows".to_string(), 6);
    goal.add_sub_goal("Add CONTRIBUTING.md and CODE_OF_CONDUCT.md".to_string(), 7);
    goal.add_sub_goal("Create MANIFEST.in and manifest files".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a professional Python library/package with:\n\
         1. Standard package structure (src layout)\n\
         2. __init__.py with version and exports\n\
         3. Core modules with complete implementations\n\
         4. Type hints throughout (PEP 484)\n\
         5. Comprehensive docstrings (Google style)\n\
         6. setup.py with metadata\n\
         7. pyproject.toml with build system\n\
         8. MANIFEST.in for package data\n\
         9. Pytest test structure with fixtures\n\
         10. pytest.ini configuration\n\
         11. Sphinx documentation setup\n\
         12. GitHub Actions workflow for CI/CD\n\
         13. Pre-commit hooks configuration\n\
         14. LICENSE (MIT or Apache 2.0)\n\
         15. .gitignore for Python\n\
         16. README.md with installation and usage\n\
         17. CONTRIBUTING.md for contributors\n\
         18. CODE_OF_CONDUCT.md\n\
         19. Changelog/HISTORY.md template\n\
         20. Version management with __version__\n\
         Include examples for public API and best practices for library development."
    );

    println!("📝 Task: Generate Python Library Package\n");
    println!("🎯 Library Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating Python library...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 4 completed!\n");
}

// ============================================
// Example 5: Django Web Application
// ============================================

async fn example_5_django_web_app() {
    println!("\n=== Example 5: Generate Django Web Application ===\n");

    let mut agent = Agent::new("DjangoGenerator", "ollama::gemma3:latest");

    let mut goal = Goal::new(
        "Generate a complete Django web application with admin and authentication".to_string()
    );

    goal.add_criterion("Django project structure with multiple apps".to_string());
    goal.add_criterion("Custom user model implementation".to_string());
    goal.add_criterion("Database models for core features".to_string());
    goal.add_criterion("Admin interface customization".to_string());
    goal.add_criterion("Views and URL routing".to_string());
    goal.add_criterion("Templates with Bootstrap styling".to_string());
    goal.add_criterion("Authentication and permissions".to_string());
    goal.add_criterion("Database migrations".to_string());
    goal.add_criterion("Django REST Framework API".to_string());

    goal.add_sub_goal("Create Django project and app structure".to_string(), 0);
    goal.add_sub_goal("Design and implement custom user model".to_string(), 1);
    goal.add_sub_goal("Create models for core features".to_string(), 2);
    goal.add_sub_goal("Configure admin interface".to_string(), 3);
    goal.add_sub_goal("Create views and templates".to_string(), 4);
    goal.add_sub_goal("Set up URL routing".to_string(), 5);
    goal.add_sub_goal("Implement authentication views".to_string(), 6);
    goal.add_sub_goal("Create Django REST Framework serializers".to_string(), 7);
    goal.add_sub_goal("Set up static files and media handling".to_string(), 8);

    goal.status = GoalStatus::InProgress;
    agent.set_goal(goal.clone());

    let task = TaskRequest::new(
        "Generate a full-featured Django web application with:\n\
         1. Django project structure with multiple apps\n\
         2. Custom user model extending AbstractBaseUser\n\
         3. Models for main features (e.g., Blog posts, Comments, Categories)\n\
         4. Django ORM relationships (ForeignKey, ManyToMany)\n\
         5. Admin interface with custom actions\n\
         6. Class-based views (ListView, DetailView, CreateView)\n\
         7. Django templates with template inheritance\n\
         8. Bootstrap styling integration\n\
         9. Authentication and login required decorators\n\
         10. Permission-based access control\n\
         11. Database migrations\n\
         12. Forms with validation\n\
         13. Django REST Framework setup\n\
         14. API serializers and viewsets\n\
         15. Pagination and filtering\n\
         16. Settings for dev and production\n\
         17. Environment variable configuration\n\
         18. Logging configuration\n\
         19. Tests with Django TestCase\n\
         20. Static files and media management\n\
         21. Docker setup\n\
         22. Requirements.txt\n\
         Include examples and docstrings following Django conventions."
    );

    println!("📝 Task: Generate Django Web Application\n");
    println!("🎯 Django Features:");
    for criterion in &goal.success_criteria {
        println!("  ✓ {}", criterion.description);
    }

    println!("\n⏳ Agent is generating Django app...\n");
    let response = agent.run(task).await;

    let output = extract_output_text(&response.result());
    println!("📄 Generated Output:\n");
    println!("{}\n", output);

    println!("📊 Goal Progress: {}%", goal.get_progress());
    println!("\n✅ Example 5 completed!\n");
}

pub fn get_summary(&self) -> String

Returns a formatted summary of the goal’s current state.

Returns

A multi-line string showing the goal, status, progress, criteria, and sub-goals

Examples found in repository

examples/05_with_goals.rs (line 66)

async fn example_1_manual_goal() {
    println!("=== Example 1: Manual Goal Creation ===\n");

    // Create an agent
    let mut agent = Agent::new("MealPlanner", "ollama::gemma3:latest");

    // Create a goal manually for a complex task
    let mut goal = Goal::new(
        "Plan a healthy meal prep for the week".to_string()
    );

    // Define what success looks like
    println!("📋 Setting success criteria...");
    goal.add_criterion("7 breakfast recipes selected".to_string());
    goal.add_criterion("7 lunch recipes selected".to_string());
    goal.add_criterion("7 dinner recipes selected".to_string());
    goal.add_criterion("Shopping list created".to_string());
    goal.add_criterion("Prep schedule created".to_string());

    // Break down into steps (sub-goals)
    println!("🎯 Breaking down into sub-goals...\n");
    goal.add_sub_goal("Ask user about dietary preferences".to_string(), 0);
    goal.add_sub_goal("Ask about time available for prep".to_string(), 1);
    goal.add_sub_goal("Suggest breakfast options".to_string(), 2);
    goal.add_sub_goal("Suggest lunch options".to_string(), 3);
    goal.add_sub_goal("Suggest dinner options".to_string(), 4);
    goal.add_sub_goal("Create shopping list".to_string(), 5);
    goal.add_sub_goal("Create prep schedule".to_string(), 6);

    // Start working on the goal
    goal.status = GoalStatus::InProgress;

    // Set the goal on the agent
    agent.set_goal(goal.clone());

    // Create a task aligned with the goal
    let task = TaskRequest::new("I need help with meal planning");

    // Run the agent
    println!("⏳ Agent is working on the meal planning task...\n");
    let _response = agent.run(task).await;

    // Show the goal summary
    println!("\n📊 Goal Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 1 completed!\n");
}

// ============================================
// Example 2: Goal Progress Tracking
// ============================================

async fn example_2_goal_progress_tracking() {
    println!("\n=== Example 2: Goal Progress Tracking ===\n");

    // Create a goal for a project
    let mut goal = Goal::new(
        "Create a project plan for building a mobile app".to_string()
    );

    // Add success criteria
    goal.add_criterion("Project requirements documented".to_string());
    goal.add_criterion("Timeline created with milestones".to_string());
    goal.add_criterion("Resource allocation plan completed".to_string());
    goal.add_criterion("Risk assessment performed".to_string());

    // Add sub-goals
    goal.add_sub_goal("Gather stakeholder requirements".to_string(), 0);
    goal.add_sub_goal("Define project scope".to_string(), 1);
    goal.add_sub_goal("Create development timeline".to_string(), 2);
    goal.add_sub_goal("Allocate resources".to_string(), 3);
    goal.add_sub_goal("Identify risks and mitigation strategies".to_string(), 4);

    goal.status = GoalStatus::InProgress;

    // Simulate progress through the goal
    println!("📈 Tracking goal progress...\n");

    // Complete first sub-goal
    println!("Step 1: Gathering requirements");
    goal.complete_sub_goal(0, Some("Interviewed 5 stakeholders".to_string()));
    goal.mark_criterion_met(0, "Requirements documented".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete second sub-goal
    println!("Step 2: Defining scope");
    goal.complete_sub_goal(1, Some("Scope document created".to_string()));
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete third sub-goal
    println!("Step 3: Creating timeline");
    goal.complete_sub_goal(2, Some("12-month timeline with milestones".to_string()));
    goal.mark_criterion_met(1, "Timeline created".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fourth sub-goal
    println!("Step 4: Allocating resources");
    goal.complete_sub_goal(3, Some("Resource allocation table created".to_string()));
    goal.mark_criterion_met(2, "Resources allocated".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Complete fifth sub-goal
    println!("Step 5: Assessing risks");
    goal.complete_sub_goal(4, Some("Risk register created with 8 identified risks".to_string()));
    goal.mark_criterion_met(3, "Risks identified".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Show final status
    println!("\n📊 Final Goal Status:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 2 completed!\n");
}

// ============================================
// Example 3: Job Interview Preparation Goal
// ============================================

async fn example_3_interview_preparation() {
    println!("\n=== Example 3: Job Interview Preparation Goal ===\n");

    let mut agent = Agent::new("InterviewCoach", "ollama::gemma3:latest");

    // Create a structured goal for interview prep
    let mut goal = Goal::new(
        "Prepare for a senior software engineer interview at a tech company".to_string()
    );

    // Define success criteria
    println!("🎯 Success criteria:");
    goal.add_criterion("Technical topics reviewed (algorithms, data structures, system design)".to_string());
    goal.add_criterion("Behavioral questions prepared with STAR method examples".to_string());
    goal.add_criterion("Company research completed".to_string());
    goal.add_criterion("Practice mock interview conducted".to_string());
    goal.add_criterion("Questions to ask the interviewer prepared".to_string());

    for criterion in &goal.success_criteria {
        println!("  • {}", criterion.description);
    }

    // Define steps
    println!("\n📋 Steps to take:");
    goal.add_sub_goal("Review core algorithms and data structures".to_string(), 0);
    goal.add_sub_goal("Study system design patterns".to_string(), 1);
    goal.add_sub_goal("Prepare STAR method stories from past projects".to_string(), 2);
    goal.add_sub_goal("Research company background and culture".to_string(), 3);
    goal.add_sub_goal("Practice mock interview with a friend".to_string(), 4);
    goal.add_sub_goal("Prepare thoughtful questions about the role".to_string(), 5);

    for sub_goal in &goal.sub_goals {
        println!("  {}. {}", sub_goal.priority + 1, sub_goal.description);
    }

    goal.status = GoalStatus::InProgress;

    // Set goal on agent
    agent.set_goal(goal.clone());

    // Create related task
    let task = TaskRequest::new("Help me prepare for my senior engineer interview");

    println!("\n⏳ Agent is creating interview preparation plan...\n");
    let _response = agent.run(task).await;

    println!("\n📊 Goal Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 3 completed!\n");
}

// ============================================
// Example 4: Goal Analysis from Task Description
// ============================================

fn example_4_goal_analysis() {
    println!("\n=== Example 4: Goal Analysis from Task Description ===\n");

    // Simulate LLM analyzing a task and breaking it down into a goal
    let task_description = "Help me learn Python programming";

    println!("📝 Original task: \"{}\"", task_description);
    println!("\n🔍 LLM analyzing task...\n");

    // This is what the LLM would return
    let analysis = GoalAnalysis {
        main_goal: "Help user learn Python programming from basics to practical skills".to_string(),
        success_criteria: vec![
            "User's current skill level identified".to_string(),
            "Learning path created based on skill level".to_string(),
            "Resources (tutorials, books) provided".to_string(),
            "Practice exercises suggested".to_string(),
            "Study schedule created".to_string(),
        ],
        sub_goals: vec![
            "Ask about current programming experience".to_string(),
            "Identify learning goals (web dev, data science, etc)".to_string(),
            "Create structured learning path".to_string(),
            "Recommend learning resources".to_string(),
            "Suggest practice projects".to_string(),
            "Create study timeline".to_string(),
        ],
    };

    // Convert analysis to a Goal
    let goal = analysis.to_goal();

    println!("✅ Goal created from analysis:\n");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 4 completed!\n");
}

// ============================================
// Example 5: Goal Completion Verification
// ============================================

async fn example_5_goal_completion() {
    println!("\n=== Example 5: Goal Completion Verification ===\n");

    let mut goal = Goal::new("Plan a birthday party".to_string());

    // Set up success criteria
    goal.add_criterion("Guest list created".to_string());
    goal.add_criterion("Venue booked".to_string());
    goal.add_criterion("Food ordered".to_string());
    goal.add_criterion("Decorations purchased".to_string());

    // Set up sub-goals
    goal.add_sub_goal("Ask about guests".to_string(), 0);
    goal.add_sub_goal("Choose and book venue".to_string(), 1);
    goal.add_sub_goal("Order food".to_string(), 2);
    goal.add_sub_goal("Purchase decorations".to_string(), 3);

    goal.status = GoalStatus::InProgress;

    println!("🎉 Birthday party planning task started\n");
    println!("Initial progress: {}%\n", goal.get_progress());

    // Simulate completing tasks
    println!("Working through sub-goals:\n");

    // Task 1
    println!("✓ Contacted 15 friends and family members");
    goal.complete_sub_goal(0, Some("Got 15 confirmations".to_string()));
    goal.mark_criterion_met(0, "List of 15 guests confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 2
    println!("✓ Booked the community center for Saturday");
    goal.complete_sub_goal(1, Some("Community center reserved for 6pm".to_string()));
    goal.mark_criterion_met(1, "Community center booking confirmed".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 3
    println!("✓ Ordered pizza and drinks for 15 people");
    goal.complete_sub_goal(2, Some("Pizza and drinks ordered".to_string()));
    goal.mark_criterion_met(2, "Food catering arranged".to_string());
    println!("  Progress: {}%", goal.get_progress());

    // Task 4
    println!("✓ Bought balloons, streamers, and table decorations");
    goal.complete_sub_goal(3, Some("All decorations purchased".to_string()));
    goal.mark_criterion_met(3, "Decorations ready".to_string());
    println!("  Progress: {}%\n", goal.get_progress());

    // Check completion
    if goal.is_successful() {
        println!("🎊 All success criteria met!");
        goal.status = GoalStatus::Completed;
    }

    if goal.all_sub_goals_complete() {
        println!("✅ All sub-goals completed!");
    }

    println!("\nFinal Status:");
    println!("  Status: {:?}", goal.status);
    println!("  All criteria met: {}", goal.is_successful());
    println!("  Progress: {}%\n", goal.get_progress());

    println!("📊 Final Summary:");
    println!("{}", goal.get_summary());

    println!("\n✅ Example 5 completed!\n");
}

// ============================================
// Example 6: Complex Multi-Step Project
// ============================================

async fn example_6_complex_project() {
    println!("\n=== Example 6: Complex Multi-Step Project Goal ===\n");

    let mut goal = Goal::new(
        "Launch a new web application product".to_string()
    );

    // Success criteria
    goal.add_criterion("Technical architecture designed and documented".to_string());
    goal.add_criterion("Frontend and backend development completed".to_string());
    goal.add_criterion("Testing completed (unit, integration, E2E)".to_string());
    goal.add_criterion("Deployment pipeline set up".to_string());
    goal.add_criterion("Marketing materials prepared".to_string());
    goal.add_criterion("Team trained on deployment and support".to_string());

    // Sub-goals in order
    goal.add_sub_goal("Define technical requirements and architecture".to_string(), 0);
    goal.add_sub_goal("Set up development environment and CI/CD".to_string(), 1);
    goal.add_sub_goal("Develop backend API endpoints".to_string(), 2);
    goal.add_sub_goal("Build frontend user interface".to_string(), 3);
    goal.add_sub_goal("Write comprehensive test suite".to_string(), 4);
    goal.add_sub_goal("Conduct security audit".to_string(), 5);
    goal.add_sub_goal("Set up monitoring and logging".to_string(), 6);
    goal.add_sub_goal("Deploy to staging environment".to_string(), 7);
    goal.add_sub_goal("Perform final testing and QA".to_string(), 8);
    goal.add_sub_goal("Create deployment documentation".to_string(), 9);
    goal.add_sub_goal("Train support team".to_string(), 10);
    goal.add_sub_goal("Deploy to production".to_string(), 11);

    goal.status = GoalStatus::InProgress;

    println!("🚀 Web Application Product Launch Plan\n");
    println!("Total steps: {}\n", goal.sub_goals.len());

    // Simulate progress
    let completed_steps = vec![
        (0, "Architecture documented with diagrams"),
        (1, "GitHub Actions CI/CD configured"),
        (2, "All 15 API endpoints implemented and tested"),
        (3, "React frontend with all pages completed"),
        (4, "Jest test suite with 85% coverage"),
        (5, "No critical vulnerabilities found"),
        (6, "Prometheus and ELK stack configured"),
        (7, "Successfully deployed to staging"),
        (8, "UAT passed with stakeholders"),
        (9, "Deployment runbook created"),
        (10, "Support team completed training"),
    ];

    for (index, notes) in completed_steps {
        goal.complete_sub_goal(index, Some(notes.to_string()));
    }

    // Mark success criteria as met
    goal.mark_criterion_met(0, "System design document completed".to_string());
    goal.mark_criterion_met(1, "All features implemented and tested".to_string());
    goal.mark_criterion_met(2, "85% test coverage achieved".to_string());
    goal.mark_criterion_met(3, "GitHub Actions and monitoring configured".to_string());
    goal.mark_criterion_met(4, "Marketing deck prepared".to_string());
    goal.mark_criterion_met(5, "Team completed deployment training".to_string());

    println!("📈 Project Progress:\n");
    println!("Overall Progress: {}%\n", goal.get_progress());

    println!("Remaining tasks:");
    if let Some(next) = goal.get_next_sub_goal() {
        println!("  • {}", next.description);
    }

    println!("\n📊 Status Summary:");
    println!("{}", goal.get_summary());

    if goal.get_progress() == 100 {
        println!("\n✅ All sub-goals completed!");
        if goal.is_successful() {
            println!("🎉 All success criteria met!");
            println!("Ready to mark goal as Completed!");
        }
    }

    println!("\n✅ Example 6 completed!\n");
}

Trait Implementations

impl Clone for Goal

fn clone(&self) -> Goal

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Goal

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Goal

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Goal

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.