Automated ai component development pipeline

[DuckyOnQuack-999]

Adds a comprehensive AI Workflow System to enable automated component enhancement and development within HyprRice, accessible via both CLI and GUI.

---

 

Summary by Sourcery

Implement a fully automated AI-powered component development pipeline in HyprRice by adding a new CLI command, GUI tab, core AIWorkflowEngine, extensive documentation, and tests to support research, analysis, code integration, GUI design, testing, and delivery workflows.

New Features:

• Add AI Workflow System for automated component enhancement with a multi-step pipeline
• Introduce hyprrice ai CLI command supporting prompts, reference images, dry-run, output and verbose modes
• Integrate AI Workflow tab into the GUI for interactive component enhancement
• Expose AIWorkflowEngine API with ai_component_pipeline entry point

Enhancements:

• Conditionally import GUI components to avoid PyQt6 dependency issues
• Update README and user documentation to include AI workflow usage and configuration

Documentation:

• Add detailed AI workflow guide in docs/ai_workflow.md and update README files

Tests:

• Add comprehensive test suite covering AI workflow engine, worker, and end-to-end integration

[sourcery-ai]

Reviewer's Guide

This PR embeds a complete AI-driven component enhancement pipeline into HyprRice by introducing a new AIWorkflowEngine core module, wiring it into both the CLI and GUI, and providing full documentation along with an extensive test suite.

File-Level Changes

Change	Details	Files
Added core AI workflow engine implementing the full 7-step pipeline	Created AIWorkflowEngine with setup, research, analysis, integration, GUI design, execution/testing, and delivery methods Defined ResearchData, ComponentAnalysis, WorkflowResult data classes Implemented helper methods for AST parsing, code modifications, prompt encoding, environment verification	src/hyprrice/ai_workflow.py AI_WORKFLOW_IMPLEMENTATION.md
Integrated AI workflow into the CLI	Added ai subcommand parser with options for prompts, reference image, dry-run, verbosity, and output redirection Implemented cmd_ai handler to drive AIWorkflowEngine and report results Updated dispatch mapping to include the new ai command	src/hyprrice/cli.py
Added GUI support for AI workflow	Created AIWorkflowTab along with ResearchDataWidget and ComponentAnalysisWidget for interactive operations Registered a new "AI Workflow" tab in the main GUI Implemented AIWorkflowWorker for background execution and progress reporting	src/hyprrice/gui/ai_workflow_tab.py src/hyprrice/main_gui.py src/hyprrice/gui/tabs.py
Adjusted package initialization for optional GUI	Wrapped main_gui import in try/except to avoid PyQt6 dependency issues Introduced GUI_AVAILABLE flag and conditional all exports	src/hyprrice/__init__.py
Expanded documentation to cover the AI workflow	Updated README.md and docs/README.md to highlight AI features Added detailed ai_workflow.md guide with usage, API reference, configuration, and examples	README.md docs/README.md docs/ai_workflow.md
Added extensive automated tests for AI workflow	Created tests covering data classes, engine methods, worker threading, and end-to-end integration Mocked external dependencies and validated error paths, caching behavior, and file operations	tests/test_ai_workflow.py

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it. You can also reply to a
  review comment with @sourcery-ai issue to create an issue from it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time. You can also comment
  @sourcery-ai title on the pull request to (re-)generate the title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time exactly where you
  want it. You can also comment @sourcery-ai summary on the pull request to
  (re-)generate the summary at any time.
• Generate reviewer's guide: Comment @sourcery-ai guide on the pull
  request to (re-)generate the reviewer's guide at any time.
• Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
  pull request to resolve all Sourcery comments. Useful if you've already
  addressed all the comments and don't want to see them anymore.
• Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
  request to dismiss all existing Sourcery reviews. Especially useful if you
  want to start fresh with a new review - don't forget to comment
  @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[cursor]

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}