Refactor ai_news_generator to use CrewAI Flows

[xpander-ai-coding-agent]

Summary

This PR refactors the ai_news_generator project to use CrewAI Flows for an agentic workflow, following the official documentation and best practices. The implementation replaces simple crew-based orchestration with a Flow-based approach that provides structured state management, task chaining, and event-driven execution.

Key Improvements

🌊 CrewAI Flows Implementation

• Created AINewsGeneratorFlow class extending Flow[NewsGenerationState]
• Implemented structured state management using Pydantic models
• Added @start() and @listen() decorators for proper flow orchestration

⚙️ Enhanced Architecture

• Research Phase (@start()): Senior Research Analyst conducts comprehensive topic research
• Content Writing Phase (@listen(research_phase)): Content Writer transforms research into engaging blog posts
• Event-driven execution ensures proper task sequencing and data flow

🎯 State Management

• Structured NewsGenerationState model for type-safe state handling
• Proper data flow between workflow phases
• Maintains topic, research report, final article, and configuration

📊 Enhanced User Experience

• Updated Streamlit UI with flow visualization
• Real-time execution feedback and progress tracking
• Improved error handling and user guidance

Technical Details

Flow Structure:

class AINewsGeneratorFlow(Flow[NewsGenerationState]):
    
    @start()
    def research_phase(self):
        # Research agent conducts comprehensive topic research
        
    @listen(research_phase)
    def content_writing_phase(self, research_report: str):
        # Writing agent transforms research into engaging content

Benefits:

• ✅ Better separation of concerns
• ✅ Structured state sharing between agents
• ✅ Event-driven workflow execution
• ✅ Enhanced error handling and logging
• ✅ Improved scalability and maintainability

Files Changed

• ai_news_generator/app.py: Complete Flow refactoring
• ai_news_generator/README.md: Updated documentation with Flow examples
• ai_news_generator/requirements.txt: Added dependency management

Testing

• ✅ Code syntax and import validation
• ✅ Flow structure and state management tests
• ✅ Pydantic model validation
• ✅ Decorator functionality verification

Closes #173

🤖 Generated with Claude Code

[coderabbitai]

Warning

Rate limit exceeded

@xpander-ai-coding-agent has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 18 minutes and 46 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 67aa2f3 and 5178ee3.

📒 Files selected for processing (3)

• ai_news_generator/README.md (1 hunks)
• ai_news_generator/app.py (4 hunks)
• ai_news_generator/requirements.txt (1 hunks)

✨ Finishing Touches

• 📝 Generate Docstrings

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

• Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  • I pushed a fix in commit <commit_id>, please review it.
  • Explain this complex logic.
  • Open a follow-up GitHub issue for this discussion.
• Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
  • @coderabbitai explain this code block.
• PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
  • @coderabbitai read src/utils.ts and explain its main purpose.
  • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR comments)

• @coderabbitai pause to pause the reviews on a PR.
• @coderabbitai resume to resume the paused reviews.
• @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
• @coderabbitai full review to do a full review from scratch and review all the files again.
• @coderabbitai summary to regenerate the summary of the PR.
• @coderabbitai generate docstrings to generate docstrings for this PR.
• @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
• @coderabbitai generate unit tests to generate unit tests for this PR.
• @coderabbitai resolve resolve all the CodeRabbit review comments.
• @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
• @coderabbitai help to get help.

Other keywords and placeholders

• Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
• Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
• Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

• You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
• Please see the configuration documentation for more information.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

• Visit our Documentation for detailed information on how to use CodeRabbit.
• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.