ROADMAP

Roadmap: Agent Control PHP Application

Phase 1: Foundation

  • Setup initial project structure (directories, base files).

  • Create mockup UI for dashboard and project details (GitHub Pages).

  • Implement Google SSO login.

  • Setup MySQL database schema for users and projects.

  • Basic dashboard for user management.

Phase 2: GitHub Integration

  • Implement GitHub OAuth for repository access.

  • Create interface to link GitHub repositories to projects.

  • Develop webhook handler for GitHub issues.

  • Basic issue-to-task mapping.

Phase 3: Agent Orchestration

  • Integrate Google Jules API.

  • Build the orchestration engine to trigger agents from issues.

  • Implement progress tracking and status updates back to GitHub.

  • Add logging and monitoring for agent activities.

Phase 4: Refinement & Scaling

  • Comprehensive test suite (Unit, Integration, E2E).

  • CI/CD pipeline optimization with caching.

  • Multi-user management features and role-based access.

  • Implement database migration strategy as described in CONCEPT_UPGRADES.md.

  • Support for multiple GitHub accounts per ai-brain user.

  • Performance tuning and security hardening.

Phase 5: Telegram Integration

  • Setup Telegram Bot and secure webhook mechanism with secret tokens.

  • Develop a dedicated webhook handler for incoming Telegram updates.

  • Implement asynchronous processing using fastcgi_finish_request() for immediate Telegram acknowledgement.

  • Connect Telegram interactions to the Google Jules orchestration engine.

  • Enable agent-to-user communication and status updates via Telegram.

Phase 6: Customization

  • Enable user-specific Telegram configuration (custom bot tokens and webhook secrets).

  • Implement per-project agent behavior configuration.

    • Define project-specific configuration schema (e.g., custom prompts, temperature, model choice).

    • Create database migration for project_settings or update projects table.

    • Implement settings UI in src/frontend/project.php.

    • Update JulesService to utilize per-project settings during agent orchestration.

⏳ Analyzing and updating the TEST_COVERAGE_IOCA.md in reasonable chunks

  • Initialize TEST_COVERAGE_IOCA.md with a comprehensive audit of existing tests (Unit, Integration, E2E) against core components.

  • Identify coverage gaps in GitHub integration and webhook handling.

  • Identify coverage gaps in Jules agent orchestration and task management.

  • Identify coverage gaps in notification delivery (Telegram, In-App).