Skip to content

Conversation

@marcusquinn
Copy link
Owner

Summary

  • Adds automatic GitHub issue creation when tasks are added via supervisor-helper.sh add or batch --tasks
  • Issues use t{NNN}: description title convention, with dedup check to avoid duplicates
  • Updates TODO.md with ref:GH#N reference and commits/pushes the change

Changes

New functions in supervisor-helper.sh:

  • create_github_issue() - Creates a GitHub issue via gh issue create, with graceful fallbacks (no gh CLI, not authenticated, no GitHub remote). Deduplicates by searching for existing issues with the task ID prefix. Auto-detects labels from description keywords. Stores issue_url in supervisor DB.
  • update_todo_with_issue_ref() - Appends ref:GH#N to the task line in TODO.md, inserting before timestamp fields. Commits and pushes the change.

Modified:

  • cmd_add() - Now calls create_github_issue() + update_todo_with_issue_ref() after DB insert. Added --no-issue flag to skip.
  • cmd_batch() - Inherits issue creation via existing cmd_add() delegation for auto-added tasks.
  • Schema: Added issue_url TEXT column to tasks table + migration for existing DBs.
  • Help text: Added --no-issue option, SUPERVISOR_AUTO_ISSUE env var, and integration docs.

Controls

Control Scope Usage
--no-issue Per-task supervisor-helper.sh add t001 --no-issue
SUPERVISOR_AUTO_ISSUE=false Global Disables for all tasks

Testing

  • bash -n syntax check: PASS
  • ShellCheck -S error: 0 violations
  • Existing test suite (46 tests): All PASS
  • Smoke help tests (331 scripts): 269 PASS, 0 FAIL
  • Manual tests: --no-issue flag, SUPERVISOR_AUTO_ISSUE=false, dedup detection

Closes #455

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 7, 2026

Warning

Rate limit exceeded

@marcusquinn has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 12 minutes and 45 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.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feature/t149

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

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist
Copy link

Summary of Changes

Hello @marcusquinn, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces a significant enhancement to the supervisor system by automating the creation of GitHub issues for newly added tasks. This integration streamlines task management by linking tasks directly to their corresponding GitHub issues, improving traceability and centralizing task-related discussions. The system also automatically updates the TODO.md file with references to these issues and provides flexible controls to enable or disable this automation as needed.

Highlights

  • Automatic GitHub Issue Creation: Tasks added via supervisor-helper.sh add or batch --tasks now automatically create corresponding GitHub issues.
  • Issue Title Convention and Deduplication: Issues are titled t{NNN}: description and checked against existing issues to prevent duplicates.
  • TODO.md Integration: The TODO.md file is automatically updated with ref:GH#N for the newly created GitHub issue, and these changes are committed and pushed.
  • New Helper Functions: Introduced create_github_issue() to handle issue creation and update_todo_with_issue_ref() to manage TODO.md updates.
  • Command Enhancements: cmd_add and cmd_batch commands now integrate the new issue creation logic.
  • Database Schema Update: A new issue_url column has been added to the tasks table, along with a migration script.
  • Configurable Behavior: The feature can be skipped per task using --no-issue or globally disabled with the SUPERVISOR_AUTO_ISSUE=false environment variable.
Changelog
  • .agents/scripts/supervisor-helper.sh
    • Added a database migration to include an issue_url column in the tasks table.
    • Modified the tasks table schema to explicitly define the issue_url column.
    • Updated the cmd_add function to support a --no-issue flag and to invoke the new GitHub issue creation and TODO.md update logic.
    • Implemented create_github_issue function, which handles gh CLI availability, authentication, repository slug detection, issue title formatting, body generation from TODO.md context, label detection, deduplication, and storing the issue URL in the database.
    • Implemented update_todo_with_issue_ref function, responsible for appending ref:GH#N to the relevant task line in TODO.md, and then committing and pushing this change.
    • Extended the help documentation to describe the new --no-issue option, the SUPERVISOR_AUTO_ISSUE environment variable, and the GitHub integration.
  • TODO.md
    • A minor update was made to a task entry t135.8.1, adding a BLOCKED note.
Activity
  • The pull request introduces a new feature for automatic GitHub issue creation.
  • Extensive testing has been performed, including bash -n syntax checks, ShellCheck, execution of the existing test suite (46 tests), and smoke tests on 331 scripts.
  • Manual tests were conducted for the --no-issue flag, SUPERVISOR_AUTO_ISSUE=false environment variable, and issue deduplication logic.
  • This pull request addresses and closes issue t149: Auto-create GitHub issues when supervisor adds/dispatches tasks #455.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@github-actions
Copy link

github-actions bot commented Feb 7, 2026

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 28 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Sat Feb 7 19:48:16 UTC 2026: Code review monitoring started
Sat Feb 7 19:48:16 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 28
Sat Feb 7 19:48:16 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Sat Feb 7 19:48:18 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 28
  • VULNERABILITIES: 0

Generated on: Sat Feb 7 19:48:19 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

@sonarqubecloud
Copy link

sonarqubecloud bot commented Feb 7, 2026

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a valuable feature to automatically create GitHub issues when tasks are added, which improves visibility and integration with project tracking. The implementation is well-structured, featuring robust checks for dependencies like the gh CLI, graceful error handling, and clear configuration options. I've identified one high-severity bug in the file update logic that could cause the script to fail with certain task descriptions. A code suggestion is provided to address this and ensure the feature is reliable.

new_line="${task_line} ref:GH#${issue_number}"
fi

sed_inplace "${line_num}s|.*|${new_line}|" "$todo_file"

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

The sed command on this line is vulnerable to special characters that might be present in the $new_line variable. If a task description in TODO.md contains the sed delimiter (|), an ampersand (&), or a backslash (\), this command will fail or produce incorrect output. This could lead to unexpected script failures or corruption of TODO.md when adding tasks with certain descriptions. To make this robust, the $new_line variable should be escaped before being used in the sed replacement string.

Suggested change
sed_inplace "${line_num}s|.*|${new_line}|" "$todo_file"
new_line=$(printf '%s' "$new_line" | sed -e 's/[\\&|]/\\&/g')
sed_inplace "${line_num}s|.*|${new_line}|" "$todo_file"

@marcusquinn marcusquinn merged commit 0e767ac into main Feb 7, 2026
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

t149: Auto-create GitHub issues when supervisor adds/dispatches tasks

1 participant