use anyhow::{Context, Result, ensure};
use super::recommendation::{Comment, Issue, is_factory_label, one_line};
use crate::claim::{AGENT_FAILED, IN_PROGRESS};
use crate::git::Git;
use crate::github::GitHub;
use crate::issue::IssueUrl;
use crate::labels::{self, Edit, Label};
use crate::trust::{self, Reads};
const AI_TRIAGE: &str = "> *This was generated by AI during triage.*\n\n";
const STATES_AND_CLAIM: [Label; 7] = [
labels::NEEDS_TRIAGE,
labels::READY_FOR_HUMAN,
labels::NEEDS_INFO,
labels::READY_FOR_AGENT,
labels::WONTFIX,
AGENT_FAILED,
IN_PROGRESS,
];
pub(super) fn check_target(issue: &IssueUrl, github: &GitHub) -> Result<()> {
ensure!(
github.issue_is_open(issue)?,
"issue #{} is closed",
issue.number
);
check_trust(issue, github)
}
pub(super) fn check_trust(issue: &IssueUrl, github: &GitHub) -> Result<()> {
if let Some(reason) = trust_reason(issue, github)? {
anyhow::bail!("issue #{} {reason}", issue.number);
}
Ok(())
}
pub(super) fn finding_notification(issue: &IssueUrl, github: &GitHub) -> Result<Option<String>> {
let current = github.issue(issue)?;
Ok(current
.labels
.names()
.any(crate::github::is_security_finding_label)
.then(|| {
format!(
"Security finding: {}\nIssue: {}\nDetails remain on the private issue and in the Command log.\n",
one_line(current.title.as_deref().unwrap_or("Security finding")),
issue.url
)
}))
}
pub(super) fn trust_reason(issue: &IssueUrl, github: &GitHub) -> Result<Option<String>> {
if !trust::trusted_association(&github.author_association(issue)?) {
return Ok(Some("author is not a Trusted account".into()));
}
if let Some(text) = trust::untrusted_edit(github, issue, None)? {
return Ok(Some(format!(
"{text} was edited by an account that is not a Trusted account"
)));
}
Ok(None)
}
pub(super) struct Claim<'a> {
issue: &'a IssueUrl,
ending: Ending,
_origin: crate::reservation::Reservation,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
enum Ending {
Unfinished,
Completed,
Paused,
}
impl<'a> Claim<'a> {
pub fn take(launch: &Git, issue: &'a IssueUrl) -> Result<Self> {
let origin = crate::reservation::Reservation::take(launch, issue)?
.with_context(|| format!("#{} is already reserved on origin", issue.number))?;
Self::reserved(issue, origin)
}
pub fn reserved(issue: &'a IssueUrl, origin: crate::reservation::Reservation) -> Result<Self> {
let github = GitHub::new();
check_target(issue, &github)?;
let labels = github.issue_labels(issue)?;
ensure!(
!labels.has(IN_PROGRESS),
"issue #{} is already Claimed",
issue.number
);
let held = Self {
issue,
ending: Ending::Unfinished,
_origin: origin,
};
Edit::of(issue, labels, &STATES_AND_CLAIM, &[IN_PROGRESS]).apply(&github)?;
Ok(held)
}
pub fn completed(&mut self) {
self.ending = Ending::Completed;
}
pub fn paused(&mut self) {
self.ending = Ending::Paused;
}
}
impl Drop for Claim<'_> {
fn drop(&mut self) {
if self.ending == Ending::Completed {
return;
}
let github = GitHub::new().completion();
let on: &[Label] = match crate::logs::stop_requested().map(|request| request.ending()) {
Some(crate::logs::stop::Ending::Requeue) => &[labels::NEEDS_TRIAGE],
Some(crate::logs::stop::Ending::Triage) => &[labels::READY_FOR_HUMAN],
None if self.ending == Ending::Paused => &[labels::NEEDS_TRIAGE],
None => &[labels::READY_FOR_HUMAN, AGENT_FAILED],
};
let ended = (|| {
let labels = github.issue_labels(self.issue)?;
Edit::of(self.issue, labels, &STATES_AND_CLAIM, on).apply(&github)
})();
if let Err(error) = ended {
crate::progress::warn(
&error,
format_args!(
"could not end Triage Claim on #{}; run: {}",
self.issue.number,
labels::by_hand(self.issue, &STATES_AND_CLAIM, on)
),
);
}
}
}
pub(super) fn publish(
target: &IssueUrl,
issue: &mut Issue,
comments: &mut [Comment],
github: &GitHub,
published: &mut Vec<IssueUrl>,
) -> Result<()> {
let filing = issue.filing();
let current = github.issue_labels(target)?;
let categories: Vec<_> = current
.names()
.filter(|name| !is_factory_label(name))
.collect();
let category = categories
.first()
.copied()
.unwrap_or(filing.category())
.to_string();
let body = format!("{AI_TRIAGE}{}{}", issue.body(), issue.notes());
github.comment_issue(target, &body)?;
published.push(target.clone());
let state = filing.state();
let add_category = categories.is_empty();
let mut edit = Edit::of(target, current, &STATES_AND_CLAIM, &[state]);
if add_category {
edit = edit.with_repository_label(filing.category());
}
edit.apply(github)?;
issue.record_in_place(body, category);
if state == labels::WONTFIX {
github.close_triaged_issue(target)?;
}
for comment in comments {
let body = format!("{AI_TRIAGE}{}", comment.body());
github.comment_issue(comment.target(), &body)?;
published.push(comment.target().clone());
comment.record_posted(body);
}
Ok(())
}