file_issues
Preview or file GitHub issues for each recorded audit finding, requiring explicit user confirmation before actually filing any issue.
Instructions
Preview or file GitHub issues for every recorded finding, via the
user's own gh CLI.
Requires config.issue_mode == "github": if the user chose in-report
delivery instead, this raises rather than filing issues nobody asked
for. Requires at least one recorded domain result.
confirm=False (the default) NEVER files anything and never invokes
gh at all: it returns a preview {repo, count, titles, instruction}
so the calling agent can show the user exactly what is about to be
filed on their repository, and get explicit agreement, before a
single issue goes out. Filing on someone's repo is outward-facing;
this confirmation step is mandatory, not decorative.
confirm=True files one issue per finding that has not already been
filed (a finding whose rule_id is already in this run's filed set is
skipped, so retrying after a partial failure does not double-file
the ones that succeeded). The target repository is `repo` if given,
otherwise detected from the audited repository directory recorded
by begin_run's repo_dir. If any issue fails to file, filing stops
immediately and the error lists exactly which rule ids were filed
(with their URLs) and which were not, so a retry knows where to
resume.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| repo | No | ||
| confirm | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||