OXYGENHUB
# b5a0a69b3622 oxygenhub / crates / hub / src / web / proposals.rs
74.3 KiB · Rust · last changed Live pages L3: the proposal page updates itself 21 days ago source blame history raw
1 
//! Proposal pages (hub spec §7): list, new, detail with conversation,
2 
//! changes and files, comments anchored to atoms, reviews, landing.
3
4 
use super::history::{render_files, FileRows};
5 
use super::settings::{csrf, require};
6 
use super::{filters, lookup, lookup_role, Error, Page, RepoShell, Shell};
7 
use crate::auth::{Access, Role, Viewer};
8 
use crate::db::{self, accounts, proposals as pdb};
9 
use crate::render::{self, diff};
10 
use crate::repos::proposals::{self as pl, Projection, Source};
11 
use crate::repos::view::{self, ChangeView, ConflictView};
12 
use crate::repos::RepoName;
13 
use crate::Shared;
14 
use askama::Template;
15 
use axum::extract::{Form, Path, Query, State};
16 
use axum::response::{IntoResponse, Redirect, Response};
17 
use hub_api::{Approval, ProposalSource, ProposalState};
18 
use oxy_core::hash::ChangeHash;
19 
use serde::Deserialize;
20 
use std::collections::{BTreeMap, HashMap};
21
22 
// ------------------------------------------------------------------ list
23
24 
#[derive(Template)]
25 
#[template(path = "proposals.html")]
26 
pub struct ProposalsPage {
27 
    shell: Shell,
28 
    repo: RepoShell,
29 
    rows: Vec<pdb::ProposalRow>,
30 
    filter: String,
31 
    counts: (usize, usize, usize),
32 
    bookmarks: Vec<String>,
33 
    q: String,
34 
    sort: String,
35 
    pager: super::Pager,
36 
    labels: std::collections::HashMap<i64, Vec<db::issues::Label>>,
37 
}
38
39 
impl ProposalsPage {
40 
    fn labels_of(&self, id: &i64) -> &[db::issues::Label] {
41 
        self.labels.get(id).map(Vec::as_slice).unwrap_or(&[])
42 
    }
43 
}
44
45 
#[derive(Deserialize)]
46 
pub struct ListQuery {
47 
    state: Option<String>,
48 
    q: Option<String>,
49 
    sort: Option<String>,
50 
    page: Option<usize>,
51 
}
52
53 
/// The list's sort orders.
54 
pub const SORTS: &[(&str, &str)] = &[("updated", "recently updated"), ("newest", "newest"), ("oldest", "oldest")];
55
56 
pub async fn list(
57 
    State(app): State<Shared>,
58 
    viewer: Viewer,
59 
    Path((owner, name)): Path<(String, String)>,
60 
    Query(q): Query<ListQuery>,
61 
) -> Result<Page<ProposalsPage>, Error> {
62 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposals"), &viewer);
63 
    let (repo, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
64 
    let all = pdb::list(&app.db, row.id, &[]).await.map_err(|e| Error::from_db(shell.clone(), e))?;
65 
    let counts = (
66 
        all.iter().filter(|p| p.is_open()).count(),
67 
        all.iter().filter(|p| p.state == "landed").count(),
68 
        all.iter().filter(|p| p.state == "closed").count(),
69 
    );
70 
    let filter = q.state.unwrap_or_else(|| "open".into());
71 
    let mut labels: std::collections::HashMap<i64, Vec<db::issues::Label>> = std::collections::HashMap::new();
72 
    for (id, l) in db::issues::labels_by_proposal(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))? {
73 
        labels.entry(id).or_default().push(l);
74 
    }
75 
    // `author:bob label:ui target:main words…`
76 
    let qtext = q.q.clone().unwrap_or_default();
77 
    let (mut authors, mut wanted, mut targets, mut words) = (vec![], vec![], vec![], vec![]);
78 
    for tok in qtext.split_whitespace() {
79 
        match tok.split_once(':') {
80 
            Some(("author", v)) => authors.push(v.to_lowercase()),
81 
            Some(("label", v)) => wanted.push(v.to_lowercase()),
82 
            Some(("target", v)) => targets.push(v.to_string()),
83 
            _ => words.push(tok.to_lowercase()),
84 
        }
85 
    }
86 
    let mut rows: Vec<pdb::ProposalRow> = all
87 
        .into_iter()
88 
        .filter(|p| match filter.as_str() {
89 
            "open" => p.is_open(),
90 
            "landed" => p.state == "landed",
91 
            "closed" => p.state == "closed",
92 
            _ => true,
93 
        })
94 
        .filter(|p| authors.is_empty() || authors.contains(&p.author.to_lowercase()))
95 
        .filter(|p| targets.is_empty() || targets.contains(&p.target))
96 
        .filter(|p| wanted.iter().all(|w| labels.get(&p.id).is_some_and(|ls| ls.iter().any(|l| l.name.to_lowercase() == *w))))
97 
        .filter(|p| words.iter().all(|w| p.title.to_lowercase().contains(w) || p.body.to_lowercase().contains(w)))
98 
        .collect();
99 
    let sort = q.sort.filter(|s| SORTS.iter().any(|(k, _)| k == s)).unwrap_or_else(|| "updated".into());
100 
    match sort.as_str() {
101 
        "newest" => rows.sort_by_key(|p| std::cmp::Reverse(p.number)),
102 
        "oldest" => rows.sort_by_key(|p| p.number),
103 
        _ => rows.sort_by_key(|p| std::cmp::Reverse(p.updated_ms)),
104 
    }
105 
    let pager = super::Pager::new(rows.len(), q.page, &[("state", &filter), ("q", &qtext), ("sort", &sort)]);
106 
    let rows = pager.slice(rows);
107 
    let bookmarks = app
108 
        .repos
109 
        .read(&repo, |r, _| Ok(r.bookmarks()?.into_iter().map(|b| b.name).collect::<Vec<_>>()))
110 
        .await
111 
        .map_err(|e| Error::from_repo(shell.clone(), e))?;
112 
    Ok(Page(ProposalsPage {
113 
        shell,
114 
        repo: RepoShell::new(&app, &row, "proposals").with_role(role),
115 
        rows,
116 
        filter,
117 
        counts,
118 
        bookmarks,
119 
        q: qtext,
120 
        sort,
121 
        pager,
122 
        labels,
123 
    }))
124 
}
125
126 
// ------------------------------------------------------------------- new
127
128 
#[derive(Template)]
129 
#[template(path = "proposal_new.html")]
130 
pub struct NewProposalPage {
131 
    shell: Shell,
132 
    repo: RepoShell,
133 
    bookmarks: Vec<String>,
134 
    source: String,
135 
    target: String,
136 
    error: Option<String>,
137 
    /// Preview: the changes the proposal would add.
138 
    preview: Vec<ChangeView>,
139 
    conflicted: bool,
140 
    /// What the form holds so far (after a failed open, or a draft).
141 
    title: String,
142 
    body: String,
143 
    /// AI assistants that may draft the description (hub spec §13.4).
144 
    assistants: Vec<String>,
145 
}
146
147 
#[derive(Deserialize)]
148 
pub struct NewQuery {
149 
    source: Option<String>,
150 
    target: Option<String>,
151 
}
152
153 
/// `owner/name:bookmark` for a fork, else a bookmark of this repository.
154 
/// A proposal's source: a bookmark of this repository by name (which may
155 
/// hold `/`, as `feature/16-hud` does), or `owner/name:bookmark` of a fork;
156 
/// `owner/name:bookmark` naming this repository is its own bookmark.
157 
fn parse_source(app: &Shared, repo: &RepoName, source: &str) -> Option<(Option<RepoName>, String)> {
158 
    let plain = |b: &str| !b.is_empty() && !b.chars().any(|c| c.is_control() || c == ':');
159 
    if let Some((slug, bookmark)) = source.split_once(':') {
160 
        let fork = RepoName::parse(slug)?;
161 
        if !plain(bookmark) {
162 
            return None;
163 
        }
164 
        if fork == *repo {
165 
            return Some((None, bookmark.to_string()));
166 
        }
167 
        if !app.repos.exists(&fork) {
168 
            return None;
169 
        }
170 
        return Some((Some(fork), bookmark.to_string()));
171 
    }
172 
    plain(source).then(|| (None, source.to_string()))
173 
}
174
175 
async fn preview_for(
176 
    app: &Shared,
177 
    repo: &RepoName,
178 
    target: &str,
179 
    source: &str,
180 
) -> Result<(Vec<ChangeView>, bool), crate::repos::RepoError> {
181 
    let Some((fork, bookmark)) = parse_source(app, repo, source) else { return Ok((vec![], false)) };
182 
    let target = target.to_string();
183 
    let fork_dir = fork.as_ref().map(|f| app.repos.dir(f));
184 
    app.repos
185 
        .read(repo, move |r, cache| {
186 
            let projection = match &fork_dir {
187 
                Some(dir) => {
188 
                    let fork_repo = oxy_core::repo::Repo::open(dir)?;
189 
                    let heads = fork_repo.bookmarks()?.into_iter().find(|b| b.name == bookmark).map(|b| b.heads).unwrap_or_default();
190 
                    pl::project(r, cache, &target, Source::Fork { fork: &fork_repo, heads })?
191 
                }
192 
                None => {
193 
                    let heads = r.bookmarks()?.into_iter().find(|b| b.name == bookmark).map(|b| b.heads).unwrap_or_default();
194 
                    pl::project(r, cache, &target, Source::Bookmark(heads))?
195 
                }
196 
            };
197 
            Ok((projection.changes, projection.conflicted))
198 
        })
199 
        .await
200 
}
201
202 
pub async fn new_form(
203 
    State(app): State<Shared>,
204 
    viewer: Viewer,
205 
    Path((owner, name)): Path<(String, String)>,
206 
    Query(q): Query<NewQuery>,
207 
) -> Result<Page<NewProposalPage>, Error> {
208 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposals/new"), &viewer);
209 
    require(&viewer, &shell)?;
210 
    let (repo, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
211 
    let bookmarks = app
212 
        .repos
213 
        .read(&repo, |r, _| Ok(r.bookmarks()?.into_iter().map(|b| b.name).collect::<Vec<_>>()))
214 
        .await
215 
        .map_err(|e| Error::from_repo(shell.clone(), e))?;
216 
    let target = q.target.unwrap_or_else(|| row.default_bookmark.clone());
217 
    let source = q.source.unwrap_or_default();
218 
    let (preview, conflicted) =
219 
        if source.is_empty() { (vec![], false) } else { preview_for(&app, &repo, &target, &source).await.unwrap_or((vec![], false)) };
220 
    let assistants = if preview.is_empty() { vec![] } else { assistant_names(&app, &row).await };
221 
    Ok(Page(NewProposalPage {
222 
        shell,
223 
        repo: RepoShell::new(&app, &row, "proposals").with_role(role),
224 
        bookmarks,
225 
        source,
226 
        target,
227 
        error: None,
228 
        preview,
229 
        conflicted,
230 
        title: String::new(),
231 
        body: String::new(),
232 
        assistants,
233 
    }))
234 
}
235
236 
#[derive(Deserialize)]
237 
pub struct NewForm {
238 
    #[serde(rename = "_csrf")]
239 
    csrf_token: String,
240 
    title: String,
241 
    #[serde(default)]
242 
    body: String,
243 
    target: String,
244 
    source: String,
245 
    #[serde(default)]
246 
    draft: Option<String>,
247 
    /// For `/proposals/new/draft`: which assistant writes the description.
248 
    #[serde(default)]
249 
    assistant: String,
250 
}
251
252 
/// Open a proposal from a form or the API: validate, create, index, notify.
253 
#[allow(clippy::too_many_arguments)]
254 
pub async fn open_proposal(
255 
    app: &Shared,
256 
    repo: &RepoName,
257 
    row: &db::repos::RepoRow,
258 
    me: &accounts::Account,
259 
    title: &str,
260 
    body: &str,
261 
    target: &str,
262 
    source: &str,
263 
    draft: bool,
264 
) -> Result<pdb::ProposalRow, String> {
265 
    if title.trim().is_empty() {
266 
        return Err("Give the proposal a title.".into());
267 
    }
268 
    let bookmarks =
269 
        app.repos.read(repo, |r, _| Ok(r.bookmarks()?.into_iter().map(|b| b.name).collect::<Vec<_>>())).await.map_err(|e| e.to_string())?;
270 
    if !bookmarks.iter().any(|b| b == target) {
271 
        return Err("Pick a target bookmark of this repository.".into());
272 
    }
273 
    let Some((fork, bookmark)) = parse_source(app, repo, source.trim()) else {
274 
        return Err("The source is a bookmark of this repository, or owner/name:bookmark of a fork.".into());
275 
    };
276 
    if fork.is_none() && !bookmarks.contains(&bookmark) {
277 
        return Err(format!("There is no bookmark {bookmark} in this repository."));
278 
    }
279 
    if fork.is_none() && bookmark == target {
280 
        return Err("The source and the target are the same bookmark.".into());
281 
    }
282 
    let (preview, _) = preview_for(app, repo, target, source.trim()).await.map_err(|e| e.to_string())?;
283 
    if preview.is_empty() {
284 
        return Err("The source adds nothing to the target.".into());
285 
    }
286 
    let source_repo_id = match &fork {
287 
        Some(fk) => db::repos::get(&app.db, &fk.owner, &fk.name).await.map_err(|e| e.to_string())?.map(|r| r.id),
288 
        None => None,
289 
    };
290 
    let created = pdb::create(
291 
        &app.db,
292 
        pdb::NewProposal {
293 
            repo_id: row.id,
294 
            title: title.trim(),
295 
            body: body.trim(),
296 
            author_id: Some(me.id),
297 
            author: &me.username,
298 
            draft,
299 
            target,
300 
            source_kind: if fork.is_some() { "fork" } else { "bookmark" },
301 
            source_repo_id,
302 
            source_bookmark: &bookmark,
303 
            source_changes: "",
304 
        },
305 
    )
306 
    .await
307 
    .map_err(|e| e.to_string())?;
308 
    pdb::add_event(&app.db, created.id, &me.username, "opened", "").await.ok();
309 
    accounts::audit(&app.db, Some(me), "proposal.opened", &format!("{}#{}", row.slug(), created.number), title).await.ok();
310 
    db::notify::index(&app.db, "proposal", row.id, created.id, created.number, &created.title, &created.body).await.ok();
311 
    let url = format!("/{}/proposal/{}", row.slug(), created.number);
312 
    crate::notify::deliver(
313 
        app,
314 
        crate::notify::Event {
315 
            kind: "proposal.opened",
316 
            title: format!("{}#{}: {}", row.slug(), created.number, created.title),
317 
            url,
318 
            actor: me,
319 
            repo_id: row.id,
320 
            thread: Some(("proposal", created.id)),
321 
            mention_text: body,
322 
            direct: vec![],
323 
        },
324 
    )
325 
    .await;
326 
    crate::hooks::emit(
327 
        app,
328 
        row,
329 
        "proposal.opened",
330 
        &me.username,
331 
        serde_json::json!({ "number": created.number, "title": created.title, "target": target, "source": source }),
332 
    )
333 
    .await;
334 
    Ok(created)
335 
}
336
337 
pub async fn create(
338 
    State(app): State<Shared>,
339 
    viewer: Viewer,
340 
    Path((owner, name)): Path<(String, String)>,
341 
    Form(f): Form<NewForm>,
342 
) -> Result<Response, Error> {
343 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposals/new"), &viewer);
344 
    let me = require(&viewer, &shell)?;
345 
    csrf(&viewer, &f.csrf_token, &shell)?;
346 
    let (repo, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
347 
    super::writable(&row, &shell)?;
348 
    match open_proposal(&app, &repo, &row, &me.account, &f.title, &f.body, &f.target, &f.source, f.draft.is_some()).await {
349 
        Ok(created) => Ok(Redirect::to(&format!("/{owner}/{name}/proposal/{}", created.number)).into_response()),
350 
        Err(msg) => {
351 
            let bookmarks =
352 
                app.repos.read(&repo, |r, _| Ok(r.bookmarks()?.into_iter().map(|b| b.name).collect::<Vec<_>>())).await.unwrap_or_default();
353 
            Ok(Page(NewProposalPage {
354 
                shell,
355 
                repo: RepoShell::new(&app, &row, "proposals").with_role(role),
356 
                bookmarks,
357 
                source: f.source.clone(),
358 
                target: f.target.clone(),
359 
                error: Some(msg),
360 
                preview: vec![],
361 
                conflicted: false,
362 
                title: f.title.clone(),
363 
                body: f.body.clone(),
364 
                assistants: vec![],
365 
            })
366 
            .into_response())
367 
        }
368 
    }
369 
}
370
371 
// ---------------------------------------------------------------- detail
372
373 
/// A comment placed on a diff row, or general.
374 
pub struct CommentView {
375 
    pub row: pdb::CommentRow,
376 
    pub body_html: String,
377 
    pub line: Option<usize>,
378 
}
379
380 
/// One entry of a proposal's conversation, in time order: what kind it
381 
/// is and its index in `comments`, `reviews` or `events`.
382 
pub struct Entry {
383 
    pub kind: &'static str,
384 
    pub index: usize,
385 
}
386
387 
pub struct ReviewView {
388 
    pub row: pdb::ReviewRow,
389 
    pub body_html: String,
390 
    pub sealed: bool,
391 
}
392
393 
/// Everything the detail page and the API need, computed once under the lock.
394 
pub struct Loaded {
395 
    pub row: pdb::ProposalRow,
396 
    pub changes: Vec<ChangeView>,
397 
    pub hashes: Vec<ChangeHash>,
398 
    pub heads: Vec<ChangeHash>,
399 
    pub target_heads: Vec<ChangeHash>,
400 
    pub state: String,
401 
    pub target_state: String,
402 
    pub conflicted: bool,
403 
    pub conflicts: Vec<ConflictView>,
404 
    pub files: Vec<FileRows>,
405 
    /// The per-file hunks and bases behind `files`, to render again with other options.
406 
    pub diffs: Vec<oxy_core::repo::FileDiff>,
407 
    pub bases: std::collections::BTreeMap<String, Vec<u8>>,
408 
    /// Atom per (path, new line number) of the projected state.
409 
    pub atoms: HashMap<(String, usize), (String, u32)>,
410 
    pub sealing_keys: Vec<String>,
411 
    pub touched: Vec<String>,
412 
    pub owners: Vec<String>,
413 
    pub landed_already: bool,
414 
    /// Whether its source has any changes at all (#141): an open proposal
415 
    /// whose source has changes, none of them missing from the target, was
416 
    /// landed by some other route.
417 
    pub source_has_changes: bool,
418 
}
419
420 
/// Compute the projection and everything derived from it.
421 
pub async fn load(app: &Shared, repo: &RepoName, row: pdb::ProposalRow) -> Result<Loaded, crate::repos::RepoError> {
422 
    let fork_dir = match (row.source_kind.as_str(), row.source_repo_id) {
423 
        ("fork", Some(id)) => {
424 
            db::repos::get_by_id(&app.db, id).await.ok().flatten().and_then(|r| RepoName::new(&r.owner, &r.name)).map(|n| app.repos.dir(&n))
425 
        }
426 
        _ => None,
427 
    };
428 
    let r2 = row.clone();
429 
    let loaded = app
430 
        .repos
431 
        .read(repo, move |r, cache| {
432 
            let source = match (r2.source_kind.as_str(), &fork_dir) {
433 
                ("changes", _) => Source::Changes(r2.source_changes().iter().filter_map(|h| ChangeHash::from_hex(h)).collect()),
434 
                ("fork", Some(dir)) => {
435 
                    let fork_repo = oxy_core::repo::Repo::open(dir)?;
436 
                    let heads =
437 
                        fork_repo.bookmarks()?.into_iter().find(|b| b.name == r2.source_bookmark).map(|b| b.heads).unwrap_or_default();
438 
                    // Bring the fork's changes over now, so the projection below can read them.
439 
                    let fork_state = fork_repo.load_state(&heads)?;
440 
                    let missing: Vec<ChangeHash> = fork_state.changes().map(|(h, _)| *h).filter(|h| !r.store().has(h)).collect();
441 
                    if !missing.is_empty() {
442 
                        r.import_bundle(&fork_repo.bundle_for(&missing)?, r.current_policy()?.is_some())?;
443 
                    }
444 
                    Source::Changes(heads)
445 
                }
446 
                _ => {
447 
                    let heads = r.bookmarks()?.into_iter().find(|b| b.name == r2.source_bookmark).map(|b| b.heads).unwrap_or_default();
448 
                    Source::Bookmark(heads)
449 
                }
450 
            };
451 
            let source_has_changes = match &source {
452 
                Source::Changes(h) | Source::Bookmark(h) | Source::Fork { heads: h, .. } => !h.is_empty(),
453 
            };
454 
            let p: Projection = pl::project(r, cache, &r2.target, source)?;
455 
            let target_loaded = cache.load(r, &p.target_heads)?;
456 
            let files = render_files(&p.files, &p.bases);
457 
            let mut atoms = HashMap::new();
458 
            for f in &files {
459 
                for l in &f.lines {
460 
                    if let Some(n) = l.new_no {
461 
                        if let Some((h, i)) = pl::atom_at(&p.loaded, &f.path, n as usize) {
462 
                            atoms.insert((f.path.clone(), n as usize), (h.to_hex(), i));
463 
                        }
464 
                    }
465 
                }
466 
            }
467 
            let touched: Vec<String> = p.files.iter().map(|f| f.path.clone()).collect();
468 
            let owners = pl::owners_for(&target_loaded, &touched);
469 
            let sealing = pl::sealing_keys(r, &p.hashes)?.into_iter().map(|k| k.to_hex()).collect();
470 
            let landed_already = !p.hashes.is_empty() && p.hashes.iter().all(|h| target_loaded.state.contains(h));
471 
            // A landed proposal's changes are in its target now: it shows
472 
            // the ones it landed, as recorded when it landed.
473 
            let (changes, hashes) = if r2.state == "landed" && p.hashes.is_empty() {
474 
                let hashes: Vec<ChangeHash> = r2.projected_changes().iter().filter_map(|h| ChangeHash::from_hex(h)).collect();
475 
                let labels = HashMap::new();
476 
                let changes = hashes
477 
                    .iter()
478 
                    .filter_map(|h| Some(view::change_view_pub(r, h, &r.store().get_change_meta(h).ok()?, false, &labels)))
479 
                    .collect();
480 
                (changes, hashes)
481 
            } else {
482 
                (p.changes, p.hashes)
483 
            };
484 
            Ok(Loaded {
485 
                row: r2,
486 
                changes,
487 
                hashes,
488 
                heads: p.heads,
489 
                target_heads: p.target_heads.clone(),
490 
                state: p.state.to_hex(),
491 
                target_state: p.target_state.to_hex(),
492 
                conflicted: p.conflicted,
493 
                conflicts: p.conflicts,
494 
                files,
495 
                diffs: p.files.clone(),
496 
                bases: p.bases.clone(),
497 
                atoms,
498 
                sealing_keys: sealing,
499 
                touched,
500 
                owners,
501 
                landed_already,
502 
                source_has_changes,
503 
            })
504 
        })
505 
        .await?;
506 
    // Landed by another route (#141): `oxy proposal land` from a client (a
507 
    // repository with a trust policy needs it), or the work merged and
508 
    // pushed by hand. Everything it proposes is in its target, so it is
509 
    // landed, not open with nothing to land.
510 
    let mut loaded = loaded;
511 
    if loaded.row.is_open()
512 
        && loaded.source_has_changes
513 
        && loaded.hashes.is_empty()
514 
        && pdb::set_landed(&app.db, loaded.row.id, &loaded.target_state, "", "push").await.is_ok()
515 
    {
516 
        loaded.row.state = "landed".into();
517 
        loaded.row.landed_via = "push".into();
518 
        loaded.row.landed_state = loaded.target_state.clone();
519 
        return Ok(loaded);
520 
    }
521 
    // Remember the projection for the list, the API and other proposals'
522 
    // stacking checks, while the proposal is open: a landed one keeps what
523 
    // it landed.
524 
    if !loaded.row.is_open() {
525 
        return Ok(loaded);
526 
    }
527 
    let heads_csv = loaded.heads.iter().map(|h| h.to_hex()).collect::<Vec<_>>().join(",");
528 
    let changes_csv = loaded.hashes.iter().map(|h| h.to_hex()).collect::<Vec<_>>().join(",");
529 
    pdb::set_projection(&app.db, loaded.row.id, &loaded.state, &heads_csv, &loaded.target_state, &changes_csv, loaded.conflicted)
530 
        .await
531 
        .ok();
532 
    Ok(loaded)
533 
}
534
535 
/// After a push moved `bookmark`: open proposals into it whose work it now
536 
/// holds are marked landed, by the pusher (#141).
537 
pub async fn settle_after_push(app: &Shared, row: &db::repos::RepoRow, bookmark: &str, actor: &str) {
538 
    let Some(repo) = RepoName::new(&row.owner, &row.name) else { return };
539 
    let Ok(open) = pdb::list(&app.db, row.id, &["open", "draft"]).await else { return };
540 
    for p in open.into_iter().filter(|p| p.target == bookmark) {
541 
        let id = p.id;
542 
        let number = p.number;
543 
        if let Ok(l) = load(app, &repo, p).await {
544 
            if l.row.state == "landed" && l.row.landed_by.is_empty() {
545 
                pdb::set_landed(&app.db, id, &l.target_state, actor, "push").await.ok();
546 
            } else if l.row.is_open() && !l.hashes.is_empty() && crate::flow::enabled(app, row) {
547 
                // The target moved, so the proposal's projected state is
548 
                // new and its checks would be for an older one (#134): run
549 
                // the pipeline on it, once.
550 
                let ran: i64 = sqlx::query_scalar("SELECT COUNT(*) FROM flow_runs WHERE repo_id = ? AND state = ?")
551 
                    .bind(row.id)
552 
                    .bind(&l.state)
553 
                    .fetch_one(&app.db)
554 
                    .await
555 
                    .unwrap_or(1);
556 
                if ran == 0 {
557 
                    let label = format!("proposal/{number}");
558 
                    match crate::flow::start_run_scoped(app, row, &label, &l.state, &l.heads, actor, "proposal", None).await {
559 
                        Ok(Some(n)) => tracing::info!("proposal {number}: its target moved; run #{n} checks its new projected state"),
560 
                        Ok(None) => {}
561 
                        Err(e) => tracing::warn!("proposal {number}: a run of its new projected state did not start: {e}"),
562 
                    }
563 
                }
564 
            }
565 
        }
566 
    }
567 
}
568
569 
/// Reviews, approvals and blockers.
570 
pub struct Verdict {
571 
    pub reviews: Vec<ReviewView>,
572 
    pub approvals: Vec<Approval>,
573 
    pub blockers: Vec<String>,
574 
    pub depends_on: Vec<i64>,
575 
    pub requirements: pdb::Requirements,
576 
}
577
578 
pub async fn verdict(app: &Shared, loaded: &Loaded, repo_id: i64) -> Result<Verdict, sqlx::Error> {
579 
    let rows = pdb::reviews(&app.db, loaded.row.id).await?;
580 
    let links = accounts::identity_accounts(&app.db).await?;
581 
    let sealed_accounts: Vec<String> = links.iter().filter(|(k, _)| loaded.sealing_keys.contains(k)).map(|(_, u)| u.clone()).collect();
582 
    // Latest verdict per reviewer.
583 
    let mut latest: BTreeMap<String, &pdb::ReviewRow> = BTreeMap::new();
584 
    for r in rows.iter().filter(|r| r.via.is_empty()) {
585 
        // An assistant's answer is never the person's own verdict.
586 
        latest.insert(r.author.clone(), r);
587 
    }
588 
    let mut approvals = Vec::new();
589 
    for (who, r) in &latest {
590 
        if r.verdict == "approve" {
591 
            let sealed = sealed_accounts.contains(who);
592 
            let key = links.iter().find(|(k, u)| u == who && loaded.sealing_keys.contains(k)).map(|(k, _)| k.clone());
593 
            approvals.push(Approval { account: who.clone(), sealed, key });
594 
        }
595 
    }
596 
    let reviews = rows
597 
        .iter()
598 
        .map(|r| ReviewView {
599 
            row: r.clone(),
600 
            body_html: render::markdown::render(&r.body, "/", "/"),
601 
            sealed: r.verdict == "approve" && sealed_accounts.contains(&r.author),
602 
        })
603 
        .collect();
604 
    let requirements = pdb::requirements(&app.db, repo_id).await?;
605 
    let mut blockers = Vec::new();
606 
    // Only an open proposal can be held back.
607 
    if !loaded.row.is_open() {
608 
        return Ok(Verdict { reviews, approvals, blockers, depends_on: vec![], requirements });
609 
    }
610 
    if loaded.row.state == "draft" {
611 
        blockers.push("the proposal is a draft".into());
612 
    }
613 
    if loaded.hashes.is_empty() {
614 
        blockers.push("the proposal adds no changes".into());
615 
    }
616 
    let sealed_count = approvals.iter().filter(|a| a.sealed).count() as i64;
617 
    if sealed_count < requirements.required_approvals {
618 
        blockers.push(format!("{sealed_count} of {} required sealed approvals", requirements.required_approvals));
619 
    }
620 
    if requirements.require_owners {
621 
        let missing: Vec<&String> = loaded.owners.iter().filter(|o| !approvals.iter().any(|a| a.sealed && &a.account == *o)).collect();
622 
        if !missing.is_empty() {
623 
            blockers.push(format!("code owners still to approve: {}", missing.iter().map(|s| s.as_str()).collect::<Vec<_>>().join(", ")));
624 
        }
625 
    }
626 
    if loaded.conflicted && !requirements.allow_conflicts {
627 
        blockers.push("landing would carry conflicts, which this repository refuses".into());
628 
    }
629 
    let required = db::hooks::required_checks(&app.db, repo_id).await?;
630 
    if !required.is_empty() {
631 
        let checks = db::hooks::checks_for_state(&app.db, repo_id, &loaded.state).await?;
632 
        let missing: Vec<String> =
633 
            required.iter().filter(|n| !checks.iter().any(|c| &c.name == *n && c.status == "passed")).cloned().collect();
634 
        if !missing.is_empty() {
635 
            blockers.push(format!("required checks not passed on the projected state: {}", missing.join(", ")));
636 
        }
637 
    }
638 
    let requesting: Vec<&String> = latest.iter().filter(|(_, r)| r.verdict == "changes").map(|(who, _)| who).collect();
639 
    if !requesting.is_empty() {
640 
        blockers.push(format!("changes requested by {}", requesting.iter().map(|s| s.as_str()).collect::<Vec<_>>().join(", ")));
641 
    }
642 
    // Stacking: another open, earlier proposal whose changes this one includes.
643 
    let mut depends_on = Vec::new();
644 
    for other in pdb::list(&app.db, repo_id, &["open", "draft"]).await? {
645 
        if other.id == loaded.row.id || other.number > loaded.row.number {
646 
            continue;
647 
        }
648 
        let theirs = other.projected_changes();
649 
        if !theirs.is_empty() && theirs.iter().all(|h| loaded.hashes.iter().any(|m| m.to_hex() == *h)) {
650 
            depends_on.push(other.number);
651 
        }
652 
    }
653 
    if !depends_on.is_empty() {
654 
        blockers.push(format!("depends on {}", depends_on.iter().map(|n| format!("#{n}")).collect::<Vec<_>>().join(", ")));
655 
    }
656 
    Ok(Verdict { reviews, approvals, blockers, depends_on, requirements })
657 
}
658
659 
#[derive(Template)]
660 
#[template(path = "proposal.html")]
661 
pub struct ProposalPage {
662 
    shell: Shell,
663 
    repo: RepoShell,
664 
    p: pdb::ProposalRow,
665 
    /// Live topics (oxygenhub#205): the proposal's and its repository's
666 
    /// (checks arrive on the latter).
667 
    live_topic: String,
668 
    repo_topic: String,
669 
    /// Assistants answering now: shown as pending until they do.
670 
    pending: Vec<String>,
671 
    /// Issues it closes, from its description and its changes.
672 
    closes: Vec<super::chain::Link>,
673 
    /// Projects the viewer may add it to.
674 
    project_choices: Option<Vec<db::projects::Project>>,
675 
    /// Comments (not anchored to a line), reviews and events, oldest first.
676 
    timeline: Vec<Entry>,
677 
    /// The viewer may set labels (triage or above).
678 
    can_triage: bool,
679 
    body_html: String,
680 
    tab: String,
681 
    changes: Vec<ChangeView>,
682 
    files: Vec<FileRows>,
683 
    diffs: Vec<oxy_core::repo::FileDiff>,
684 
    bases: std::collections::BTreeMap<String, Vec<u8>>,
685 
    /// Whitespace-only changes are hidden (`?w=1`).
686 
    ignore_ws: bool,
687 
    conflicts: Vec<ConflictView>,
688 
    conflicted: bool,
689 
    comments: Vec<CommentView>,
690 
    /// Anchored comments by (path, current line).
691 
    placed: HashMap<(String, usize), Vec<usize>>,
692 
    outdated: Vec<usize>,
693 
    reviews: Vec<ReviewView>,
694 
    approvals: Vec<Approval>,
695 
    blockers: Vec<String>,
696 
    depends_on: Vec<i64>,
697 
    events: Vec<pdb::EventRow>,
698 
    owners: Vec<String>,
699 
    requirements: pdb::Requirements,
700 
    landed_already: bool,
701 
    can_edit: bool,
702 
    /// The landed proposal's source bookmark, when it is this repository's,
703 
    /// still there, and the viewer may delete it (oxygenhub#86).
704 
    deletable_source: Option<String>,
705 
    can_land: bool,
706 
    hub_can_land: bool,
707 
    notice: Option<String>,
708 
    error: Option<String>,
709 
    heads: Vec<String>,
710 
    state_hash: String,
711 
    source_label: String,
712 
    api_url: String,
713 
    labels: Vec<db::issues::Label>,
714 
    all_labels: Vec<db::issues::Label>,
715 
    checks: Vec<db::hooks::Check>,
716 
    required_checks: Vec<String>,
717 
    /// Projects this proposal is on that the viewer may see, with the column.
718 
    projects: Vec<(db::projects::Project, String)>,
719 
    /// Asked to review and not yet reviewing.
720 
    requested: Vec<String>,
721 
    /// Who can be asked to review, for the sidebar's menu (oxygenhub#84).
722 
    reviewable: Vec<String>,
723 
    /// The viewer may ask for reviews (the author, or a writer).
724 
    can_request: bool,
725 
    /// AI assistants the viewer may ask, by name (hub spec §13.4).
726 
    assistants: Vec<String>,
727 
    /// A description an assistant just drafted, for the editor.
728 
    draft: Option<String>,
729 
}
730
731 
#[derive(Deserialize)]
732 
pub struct DetailQuery {
733 
    tab: Option<String>,
734 
    /// What an action said, after it redirected here.
735 
    #[serde(default)]
736 
    notice: Option<String>,
737 
    #[serde(default)]
738 
    error: Option<String>,
739 
    #[serde(default)]
740 
    w: Option<String>,
741 
    /// Only this part of the page (live pages, oxygenhub#205).
742 
    #[serde(default)]
743 
    fragment: Option<String>,
744 
}
745
746 
/// The page assembler every action ends in; its arguments are the route
747 
/// plus what to say, and a struct would only rename them.
748 
#[allow(clippy::too_many_arguments)]
749 
async fn detail(
750 
    app: &Shared,
751 
    shell: Shell,
752 
    viewer: &Viewer,
753 
    owner: &str,
754 
    name: &str,
755 
    number: i64,
756 
    tab: String,
757 
    notice: Option<String>,
758 
    error: Option<String>,
759 
) -> Result<Page<ProposalPage>, Error> {
760 
    let (repo, row, role) = lookup(app, &shell, viewer, owner, name).await?;
761 
    let p = pdb::get(&app.db, row.id, number)
762 
        .await
763 
        .map_err(|e| Error::from_db(shell.clone(), e))?
764 
        .ok_or_else(|| Error::not_found(shell.clone()))?;
765 
    let p_id = p.id;
766 
    let loaded = load(app, &repo, p).await.map_err(|e| Error::from_repo(shell.clone(), e))?;
767 
    // A proposal whose changes all reached the target landed by another route.
768 
    if loaded.landed_already && loaded.row.is_open() {
769 
        pdb::set_state(&app.db, loaded.row.id, "landed", &loaded.target_state).await.ok();
770 
        pdb::add_event(&app.db, loaded.row.id, "", "landed", "every change reached the target").await.ok();
771 
    }
772 
    let p = pdb::get(&app.db, row.id, number).await.map_err(|e| Error::from_db(shell.clone(), e))?.unwrap_or(loaded.row.clone());
773 
    let v = verdict(app, &loaded, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
774 
    let comment_rows = pdb::comments(&app.db, loaded.row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
775 
    let events = pdb::events(&app.db, loaded.row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
776 
    // Place anchored comments at their atom's current line.
777 
    let mut by_atom: HashMap<(String, String, u32), usize> = HashMap::new();
778 
    for ((path, line), (h, i)) in &loaded.atoms {
779 
        by_atom.insert((path.clone(), h.clone(), *i), *line);
780 
    }
781 
    let mut comments = Vec::new();
782 
    let mut placed: HashMap<(String, usize), Vec<usize>> = HashMap::new();
783 
    let mut outdated = Vec::new();
784 
    for (idx, c) in comment_rows.into_iter().enumerate() {
785 
        let line = if c.anchor_change.is_empty() {
786 
            None
787 
        } else {
788 
            by_atom.get(&(c.path.clone(), c.anchor_change.clone(), c.anchor_index as u32)).copied()
789 
        };
790 
        if !c.anchor_change.is_empty() {
791 
            match line {
792 
                Some(l) => placed.entry((c.path.clone(), l)).or_default().push(idx),
793 
                None => outdated.push(idx),
794 
            }
795 
        }
796 
        comments.push(CommentView { body_html: render::markdown::render(&c.body, "/", "/"), row: c, line });
797 
    }
798 
    let mut changes = loaded.changes.clone();
799 
    super::attribute(app, &mut changes.iter_mut().collect::<Vec<_>>()).await;
800 
    let me = viewer.account();
801 
    let can_edit = me.is_some_and(|a| Some(a.id) == p.author_id || role >= Role::Maintain);
802 
    let deletable_source =
803 
        if p.state == "landed" && p.source_kind == "bookmark" && role >= Role::Write && p.source_bookmark != row.default_bookmark {
804 
            let b = p.source_bookmark.clone();
805 
            app.repos
806 
                .read(&repo, move |r, _| Ok(r.view()?.bookmarks.contains_key(&b)))
807 
                .await
808 
                .unwrap_or(false)
809 
                .then(|| p.source_bookmark.clone())
810 
        } else {
811 
            None
812 
        };
813 
    let can_land = role >= Role::Write && p.is_open() && v.blockers.is_empty();
814 
    let can_request = p.is_open() && me.is_some_and(|a| Some(a.id) == p.author_id || role >= Role::Write);
815 
    let requested = pdb::review_requests(&app.db, p.id).await.unwrap_or_default();
816 
    let mut reviewable: Vec<String> = if can_request {
817 
        accounts::assignable(&app.db, row.id, &row.owner).await.unwrap_or_default().into_iter().filter(|u| *u != p.author).collect()
818 
    } else {
819 
        Vec::new()
820 
    };
821 
    for r in &requested {
822 
        if !reviewable.iter().any(|x| x.eq_ignore_ascii_case(r)) {
823 
            reviewable.push(r.clone());
824 
        }
825 
    }
826 
    let assistants: Vec<String> = if (can_request || can_edit) && p.is_open() { assistant_names(app, &row).await } else { Vec::new() };
827 
    let delegated = match viewer.account() {
828 
        Some(a) => super::edit::delegated_identity(app, a.id).await.is_some(),
829 
        None => false,
830 
    };
831 
    let hub_can_land = delegated || app.repos.read(&repo, |r, _| Ok(r.current_policy()?.is_none())).await.unwrap_or(false);
832 
    let source_label = match p.source_kind.as_str() {
833 
        "fork" => format!(
834 
            "fork {}",
835 
            db::repos::get_by_id(&app.db, p.source_repo_id.unwrap_or(0))
836 
                .await
837 
                .ok()
838 
                .flatten()
839 
                .map(|r| format!("{}:{}", r.slug(), p.source_bookmark))
840 
                .unwrap_or_default()
841 
        ),
842 
        "changes" => format!("{} changes", p.source_changes().len()),
843 
        _ => p.source_bookmark.clone(),
844 
    };
845 
    let projects = super::projects::placements_for(app, viewer, &row, p.number).await;
846 
    let texts: Vec<String> = std::iter::once(p.body.clone()).chain(changes.iter().map(|c| format!("{}\n{}", c.title, c.body))).collect();
847 
    let closes = super::chain::issues_closed_by(app, &row, &texts.iter().map(String::as_str).collect::<Vec<_>>()).await;
848 
    let project_choices = super::projects::project_choices(app, viewer, &row, &projects).await;
849 
    let mut dated: Vec<(i64, Entry)> = Vec::new();
850 
    for (index, c) in comments.iter().enumerate() {
851 
        if c.row.anchor_change.is_empty() {
852 
            dated.push((c.row.created_ms, Entry { kind: "comment", index }));
853 
        }
854 
    }
855 
    for (index, r) in v.reviews.iter().enumerate() {
856 
        dated.push((r.row.created_ms, Entry { kind: "review", index }));
857 
    }
858 
    for (index, e) in events.iter().enumerate() {
859 
        dated.push((e.at_ms, Entry { kind: "event", index }));
860 
    }
861 
    dated.sort_by_key(|(at, _)| *at);
862 
    let timeline: Vec<Entry> = dated.into_iter().map(|(_, e)| e).collect();
863 
    let pending = app.assistant_gate.lock().unwrap_or_else(|e| e.into_inner()).answering(p_id);
864 
    Ok(Page(ProposalPage {
865 
        live_topic: crate::events::topic::proposal(row.id, number),
866 
        repo_topic: crate::events::topic::repo(row.id),
867 
        pending,
868 
        can_triage: role >= Role::Triage,
869 
        timeline,
870 
        closes,
871 
        project_choices,
872 
        projects,
873 
        shell,
874 
        repo: RepoShell::new(app, &row, "proposals").with_role(role).with_sky(app, &row).await,
875 
        body_html: super::issues::markdown(app, &row, &row.default_bookmark, &p.body).await,
876 
        p,
877 
        tab,
878 
        changes,
879 
        files: loaded.files,
880 
        diffs: loaded.diffs,
881 
        bases: loaded.bases,
882 
        ignore_ws: false,
883 
        conflicts: loaded.conflicts,
884 
        conflicted: loaded.conflicted,
885 
        comments,
886 
        placed,
887 
        outdated,
888 
        reviews: v.reviews,
889 
        approvals: v.approvals,
890 
        blockers: v.blockers,
891 
        depends_on: v.depends_on,
892 
        events,
893 
        owners: loaded.owners,
894 
        requirements: v.requirements,
895 
        landed_already: loaded.landed_already,
896 
        can_edit,
897 
        deletable_source,
898 
        can_land,
899 
        hub_can_land,
900 
        notice,
901 
        error,
902 
        heads: loaded.heads.iter().map(|h| h.to_hex()).collect(),
903 
        state_hash: loaded.state.clone(),
904 
        source_label,
905 
        api_url: format!("{}/api/v1/repos/{owner}/{name}/proposals/{number}", app.config.base_url()),
906 
        labels: db::issues::proposal_labels(&app.db, loaded.row.id).await.unwrap_or_default(),
907 
        all_labels: db::issues::labels(&app.db, row.id).await.unwrap_or_default(),
908 
        checks: db::hooks::checks_for_state(&app.db, row.id, &loaded.state).await.unwrap_or_default(),
909 
        required_checks: db::hooks::required_checks(&app.db, row.id).await.unwrap_or_default(),
910 
        requested,
911 
        reviewable,
912 
        assistants,
913 
        draft: None,
914 
        can_request,
915 
    }))
916 
}
917
918 
/// Back to the proposal after an action, with what to say: a redirect, so
919 
/// reloading the page (the checks script does) never repeats the action.
920 
fn back(owner: &str, name: &str, number: i64, tab: &str, notice: Option<String>, error: Option<String>) -> Response {
921 
    let mut url = format!("/{owner}/{name}/proposal/{number}?tab={tab}");
922 
    if let Some(n) = notice {
923 
        url.push_str(&format!("&notice={}", super::settings::urlencode(&n)));
924 
    }
925 
    if let Some(e) = error {
926 
        url.push_str(&format!("&error={}", super::settings::urlencode(&e)));
927 
    }
928 
    Redirect::to(&url).into_response()
929 
}
930
931 
pub async fn show(
932 
    State(app): State<Shared>,
933 
    viewer: Viewer,
934 
    Path((owner, name, number)): Path<(String, String, i64)>,
935 
    Query(q): Query<DetailQuery>,
936 
) -> Result<Response, Error> {
937 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposal/{number}"), &viewer);
938 
    let mut page =
939 
        detail(&app, shell, &viewer, &owner, &name, number, q.tab.unwrap_or_else(|| "conversation".into()), q.notice, q.error).await?;
940 
    if q.w.as_deref() == Some("1") {
941 
        // Hide whitespace-only changes: the same hunks, rendered again.
942 
        page.0.files =
943 
            super::history::render_files_with(&page.0.diffs, &page.0.bases, crate::render::diff::Options { ignore_whitespace: true });
944 
        page.0.ignore_ws = true;
945 
    }
946 
    // A live page asks for one part again (oxygenhub#205): rendered by the
947 
    // same route, so the same access, and cut from the whole.
948 
    if let Some(name) = q.fragment.as_deref() {
949 
        let html = page.0.render().map_err(|e| Error::bad(page.0.shell.clone(), e.to_string()))?;
950 
        return Ok(match super::fragment(&html, name) {
951 
            Some(part) => ([(axum::http::header::CACHE_CONTROL, "no-store")], axum::response::Html(part)).into_response(),
952 
            None => (axum::http::StatusCode::NOT_FOUND, "no such fragment").into_response(),
953 
        });
954 
    }
955 
    Ok(page.into_response())
956 
}
957
958 
// ---------------------------------------------------------------- actions
959
960 
#[derive(Deserialize)]
961 
pub struct CommentForm {
962 
    #[serde(rename = "_csrf")]
963 
    csrf_token: String,
964 
    body: String,
965 
    #[serde(default)]
966 
    path: String,
967 
    #[serde(default)]
968 
    line: Option<usize>,
969 
}
970
971 
pub async fn comment(
972 
    State(app): State<Shared>,
973 
    viewer: Viewer,
974 
    Path((owner, name, number)): Path<(String, String, i64)>,
975 
    Form(f): Form<CommentForm>,
976 
) -> Result<Response, Error> {
977 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposal/{number}"), &viewer);
978 
    let me = require(&viewer, &shell)?;
979 
    csrf(&viewer, &f.csrf_token, &shell)?;
980 
    let (repo, row, _) = lookup(&app, &shell, &viewer, &owner, &name).await?;
981 
    super::writable(&row, &shell)?;
982 
    let p = pdb::get(&app.db, row.id, number)
983 
        .await
984 
        .map_err(|e| Error::from_db(shell.clone(), e))?
985 
        .ok_or_else(|| Error::not_found(shell.clone()))?;
986 
    if f.body.trim().is_empty() {
987 
        return Ok(back(&owner, &name, number, "conversation", None, Some("An empty comment says nothing.".into())));
988 
    }
989 
    let anchor = match (f.path.trim(), f.line) {
990 
        ("", _) | (_, None) => None,
991 
        (path, Some(line)) => {
992 
            let loaded = load(&app, &repo, p.clone()).await.map_err(|e| Error::from_repo(shell.clone(), e))?;
993 
            loaded.atoms.get(&(path.to_string(), line)).cloned()
994 
        }
995 
    };
996 
    let tab = if anchor.is_some() { "files" } else { "conversation" };
997 
    pdb::add_comment(
998 
        &app.db,
999 
        p.id,
1000 
        Some(me.account.id),
1001 
        &me.account.username,
1002 
        f.body.trim(),
1003 
        f.path.trim(),
1004 
        anchor.as_ref().map(|(h, i)| (h.as_str(), *i as i64)),
1005 
    )
1006 
    .await
1007 
    .map_err(|e| Error::from_db(shell.clone(), e))?;
1008 
    app.events.live.publish(&crate::events::topic::proposal(row.id, number), "comment");
1009 
    Ok(back(&owner, &name, number, tab, None, None))
1010 
}
1011
1012 
#[derive(Deserialize)]
1013 
pub struct ReviewForm {
1014 
    #[serde(rename = "_csrf")]
1015 
    csrf_token: String,
1016 
    verdict: String,
1017 
    #[serde(default)]
1018 
    body: String,
1019 
}
1020
1021 
pub async fn review(
1022 
    State(app): State<Shared>,
1023 
    viewer: Viewer,
1024 
    Path((owner, name, number)): Path<(String, String, i64)>,
1025 
    Form(f): Form<ReviewForm>,
1026 
) -> Result<Response, Error> {
1027 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposal/{number}"), &viewer);
1028 
    let me = require(&viewer, &shell)?;
1029 
    csrf(&viewer, &f.csrf_token, &shell)?;
1030 
    let (_, row, _) = lookup(&app, &shell, &viewer, &owner, &name).await?;
1031 
    super::writable(&row, &shell)?;
1032 
    let p = pdb::get(&app.db, row.id, number)
1033 
        .await
1034 
        .map_err(|e| Error::from_db(shell.clone(), e))?
1035 
        .ok_or_else(|| Error::not_found(shell.clone()))?;
1036 
    if !matches!(f.verdict.as_str(), "comment" | "changes" | "approve") {
1037 
        return Err(Error::bad(shell, "a review is comment, changes or approve"));
1038 
    }
1039 
    if f.verdict == "approve" && Some(me.account.id) == p.author_id {
1040 
        return Ok(back(&owner, &name, number, "conversation", None, Some("You cannot approve your own proposal.".into())));
1041 
    }
1042 
    pdb::add_review(&app.db, p.id, me.account.id, &me.account.username, &f.verdict, f.body.trim())
1043 
        .await
1044 
        .map_err(|e| Error::from_db(shell.clone(), e))?;
1045 
    pdb::add_event(&app.db, p.id, &me.account.username, &format!("review.{}", f.verdict), "").await.ok();
1046 
    reviewed(&app, &row, &p, &me.account, &f.verdict).await;
1047 
    crate::hooks::emit(&app, &row, "review", &me.account.username, serde_json::json!({ "number": number, "verdict": f.verdict })).await;
1048 
    let notice = if f.verdict == "approve" {
1049 
        Some(format!(
1050 
            "Approval recorded. It counts once you seal the changes: oxy seal --proposal {}/{owner}/{name}/proposal/{number}",
1051 
            app.config.base_url()
1052 
        ))
1053 
    } else {
1054 
        None
1055 
    };
1056 
    Ok(back(&owner, &name, number, "conversation", notice, None))
1057 
}
1058
1059 
#[derive(Deserialize)]
1060 
pub struct EditForm {
1061 
    #[serde(rename = "_csrf")]
1062 
    csrf_token: String,
1063 
    title: String,
1064 
    #[serde(default)]
1065 
    body: String,
1066 
    target: String,
1067 
}
1068
1069 
pub async fn edit(
1070 
    State(app): State<Shared>,
1071 
    viewer: Viewer,
1072 
    Path((owner, name, number)): Path<(String, String, i64)>,
1073 
    Form(f): Form<EditForm>,
1074 
) -> Result<Response, Error> {
1075 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposal/{number}"), &viewer);
1076 
    let me = require(&viewer, &shell)?;
1077 
    csrf(&viewer, &f.csrf_token, &shell)?;
1078 
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
1079 
    let p = pdb::get(&app.db, row.id, number)
1080 
        .await
1081 
        .map_err(|e| Error::from_db(shell.clone(), e))?
1082 
        .ok_or_else(|| Error::not_found(shell.clone()))?;
1083 
    if Some(me.account.id) != p.author_id && role < Role::Maintain {
1084 
        return Err(Error::not_found(shell));
1085 
    }
1086 
    let target = if crate::repos::names::valid_segment(f.target.trim()) { f.target.trim() } else { &p.target };
1087 
    pdb::edit(&app.db, p.id, f.title.trim(), f.body.trim(), target).await.map_err(|e| Error::from_db(shell.clone(), e))?;
1088 
    pdb::add_event(&app.db, p.id, &me.account.username, "edited", "").await.ok();
1089 
    Ok(back(&owner, &name, number, "conversation", Some("Saved.".into()), None))
1090 
}
1091
1092 
#[derive(Deserialize)]
1093 
pub struct StateForm {
1094 
    #[serde(rename = "_csrf")]
1095 
    csrf_token: String,
1096 
    action: String,
1097 
}
1098
1099 
pub async fn state(
1100 
    State(app): State<Shared>,
1101 
    viewer: Viewer,
1102 
    Path((owner, name, number)): Path<(String, String, i64)>,
1103 
    Form(f): Form<StateForm>,
1104 
) -> Result<Response, Error> {
1105 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposal/{number}"), &viewer);
1106 
    let me = require(&viewer, &shell)?;
1107 
    csrf(&viewer, &f.csrf_token, &shell)?;
1108 
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
1109 
    let p = pdb::get(&app.db, row.id, number)
1110 
        .await
1111 
        .map_err(|e| Error::from_db(shell.clone(), e))?
1112 
        .ok_or_else(|| Error::not_found(shell.clone()))?;
1113 
    if Some(me.account.id) != p.author_id && role < Role::Triage {
1114 
        return Err(Error::not_found(shell));
1115 
    }
1116 
    let new_state = match (f.action.as_str(), p.state.as_str()) {
1117 
        ("close", "open" | "draft") => "closed",
1118 
        ("reopen", "closed") => "open",
1119 
        ("ready", "draft") => "open",
1120 
        ("draft", "open") => "draft",
1121 
        _ => return Err(Error::bad(shell, "that transition is not possible")),
1122 
    };
1123 
    pdb::set_state(&app.db, p.id, new_state, "").await.map_err(|e| Error::from_db(shell.clone(), e))?;
1124 
    pdb::add_event(&app.db, p.id, &me.account.username, new_state, "").await.ok();
1125 
    crate::hooks::emit(&app, &row, &format!("proposal.{new_state}"), &me.account.username, serde_json::json!({ "number": number })).await;
1126 
    Ok(back(&owner, &name, number, "conversation", None, None))
1127 
}
1128
1129 
pub async fn resolve_comment(
1130 
    State(app): State<Shared>,
1131 
    viewer: Viewer,
1132 
    Path((owner, name, number, id)): Path<(String, String, i64, i64)>,
1133 
    Form(f): Form<super::session::CsrfForm>,
1134 
) -> Result<Response, Error> {
1135 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposal/{number}"), &viewer);
1136 
    require(&viewer, &shell)?;
1137 
    csrf(&viewer, &f.csrf, &shell)?;
1138 
    let (_, row, _) = lookup(&app, &shell, &viewer, &owner, &name).await?;
1139 
    let p = pdb::get(&app.db, row.id, number)
1140 
        .await
1141 
        .map_err(|e| Error::from_db(shell.clone(), e))?
1142 
        .ok_or_else(|| Error::not_found(shell.clone()))?;
1143 
    let current: Option<bool> = sqlx::query_scalar("SELECT resolved FROM proposal_comments WHERE id = ? AND proposal_id = ?")
1144 
        .bind(id)
1145 
        .bind(p.id)
1146 
        .fetch_optional(&app.db)
1147 
        .await
1148 
        .map_err(|e| Error::from_db(shell.clone(), e))?;
1149 
    if let Some(r) = current {
1150 
        pdb::set_comment_resolved(&app.db, id, !r).await.map_err(|e| Error::from_db(shell.clone(), e))?;
1151 
    }
1152 
    Ok(back(&owner, &name, number, "files", None, None))
1153 
}
1154
1155 
/// Land from the hub: only when the repository has no trust policy (the
1156 
/// hub never signs a reference update the policy would have to admit).
1157 
pub async fn land(
1158 
    State(app): State<Shared>,
1159 
    viewer: Viewer,
1160 
    Path((owner, name, number)): Path<(String, String, i64)>,
1161 
    Form(f): Form<super::session::CsrfForm>,
1162 
) -> Result<Response, Error> {
1163 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposal/{number}"), &viewer);
1164 
    let me = require(&viewer, &shell)?;
1165 
    csrf(&viewer, &f.csrf, &shell)?;
1166 
    let (repo, row, _) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Write).await?;
1167 
    match land_as(&app, &repo, &row, &me.account, number, "web", false).await {
1168 
        Ok(_) => Ok(back(&owner, &name, number, "conversation", Some("Landed.".into()), None)),
1169 
        Err(Landing::NotFound) => Err(Error::not_found(shell)),
1170 
        Err(Landing::Refused(m)) => Ok(back(&owner, &name, number, "conversation", None, Some(m))),
1171 
    }
1172 
}
1173
1174 
/// Why a proposal did not land.
1175 
pub enum Landing {
1176 
    NotFound,
1177 
    Refused(String),
1178 
}
1179
1180 
/// Land proposal `number` as `me` (hub spec §8.4), who has write access:
1181 
/// refused while it is not open or has blockers. Moves the target bookmark
1182 
/// (attested by the hub key on `me`'s behalf when they delegated to it),
1183 
/// then records, announces and audits the landing, saying how it was done
1184 
/// (`via`: `web`, or `api (token NAME)`). `as_hub` signs with the hub's own
1185 
/// key rather than `me`'s delegation (Diffusion's auto-land). Returns the
1186 
/// new state.
1187 
pub async fn land_as(
1188 
    app: &Shared,
1189 
    repo: &RepoName,
1190 
    row: &db::repos::RepoRow,
1191 
    me: &accounts::Account,
1192 
    number: i64,
1193 
    via: &str,
1194 
    as_hub: bool,
1195 
) -> Result<String, Landing> {
1196 
    let (owner, name) = (row.owner.clone(), row.name.clone());
1197 
    let refused = |e: String| Landing::Refused(e);
1198 
    let p = pdb::get(&app.db, row.id, number).await.map_err(|e| refused(e.to_string()))?.ok_or(Landing::NotFound)?;
1199 
    let loaded = load(app, repo, p.clone()).await.map_err(|e| refused(e.to_string()))?;
1200 
    let v = verdict(app, &loaded, row.id).await.map_err(|e| refused(e.to_string()))?;
1201 
    if !p.is_open() {
1202 
        return Err(refused(format!("Cannot land: the proposal is {}", p.state)));
1203 
    }
1204 
    if !v.blockers.is_empty() {
1205 
        return Err(refused(format!("Cannot land: {}", v.blockers.join("; "))));
1206 
    }
1207 
    let target = p.target.clone();
1208 
    let heads = loaded.heads.clone();
1209 
    // With a delegation the landing is attested by the hub key on the
1210 
    // user's behalf, which a policy accepts when it lets the user update
1211 
    // the target (spec §14.5); without one, only a policy-free repository
1212 
    // can be landed here.
1213 
    let signer = if as_hub { super::edit::hub_signer(app) } else { super::edit::signer_for(app, me.id).await };
1214 
    let result = match signer {
1215 
        Ok(signer) => crate::repos::edits::move_bookmark(&app.repos, repo, target.clone(), heads.clone(), signer).await.map(|_| pl::state_ref(&heads).to_hex()),
1216 
        Err(why) => {
1217 
            app.repos
1218 
                .write(repo, move |r, _| {
1219 
                    if r.current_policy()?.is_some() {
1220 
                        return Err(crate::repos::RepoError::Oxy(oxy_core::repo::RepoError::Msg(format!(
1221 
                            "this repository has a trust policy, so the landing must be signed by a key it authorises. Land from a client with oxy proposal land, or delegate to the hub. {why}"
1222 
                        ))));
1223 
                    }
1224 
                    r.bookmark_set(&target, &heads)?;
1225 
                    Ok(pl::state_ref(&heads).to_hex())
1226 
                })
1227 
                .await
1228 
        }
1229 
    };
1230 
    let state = result.map_err(|e| refused(e.to_string()))?;
1231 
    pdb::set_landed(&app.db, p.id, &state, &me.username, via).await.map_err(|e| refused(e.to_string()))?;
1232 
    let how = if v.approvals.is_empty() { format!("{via}, with no approval") } else { via.to_string() };
1233 
    pdb::add_event(&app.db, p.id, &me.username, "landed", &how).await.ok();
1234 
    crate::hooks::emit(
1235 
        app,
1236 
        row,
1237 
        "proposal.landed",
1238 
        &me.username,
1239 
        serde_json::json!({ "number": number, "target": p.target, "state": state }),
1240 
    )
1241 
    .await;
1242 
    crate::notify::deliver(
1243 
        app,
1244 
        crate::notify::Event {
1245 
            kind: "proposal.landed",
1246 
            title: format!("{owner}/{name}#{number}: {} landed", p.title),
1247 
            url: format!("/{owner}/{name}/proposal/{number}"),
1248 
            actor: me,
1249 
            repo_id: row.id,
1250 
            thread: Some(("proposal", p.id)),
1251 
            mention_text: "",
1252 
            direct: p.author_id.into_iter().collect(),
1253 
        },
1254 
    )
1255 
    .await;
1256 
    if p.target == row.default_bookmark {
1257 
        let messages: Vec<(String, String)> = loaded.changes.iter().map(|c| (c.hash.clone(), format!("{}\n{}", c.title, c.body))).collect();
1258 
        super::issues::close_from_messages(app, row, &messages).await;
1259 
    }
1260 
    accounts::audit(&app.db, Some(me), "proposal.landed", &format!("{owner}/{name}#{number}"), &how).await.ok();
1261 
    db::repos::record_push(
1262 
        &app.db,
1263 
        row.id,
1264 
        Some((me.id, me.username.as_str())),
1265 
        &[db::repos::PushOutcome {
1266 
            reference: p.target.clone(),
1267 
            ok: true,
1268 
            reason: format!("landed #{number} ({how})"),
1269 
            old_state: loaded.target_state.clone(),
1270 
            new_state: state.clone(),
1271 
            heads: loaded.heads.len() as i64,
1272 
            changes: loaded.hashes.len() as i64,
1273 
        }],
1274 
    )
1275 
    .await
1276 
    .ok();
1277 
    // The target moved: its other open proposals are checked again (#134).
1278 
    settle_after_push(app, row, &p.target, &me.username).await;
1279 
    // A landing on the default bookmark closes the issues its changes (and
1280 
    // its description) say they close, as a push there would.
1281 
    if p.target == row.default_bookmark {
1282 
        let body = (format!("proposal #{number}"), p.body.clone());
1283 
        crate::web::issues::close_from_arrived(app, row, loaded.target_heads.clone(), loaded.heads.clone(), Some(body)).await;
1284 
    }
1285 
    // Diffusion (#150): a landing moves the target as a push would, so the
1286 
    // pin index follows it, and the consumers of a moved default bookmark
1287 
    // are bumped.
1288 
    let heads = loaded.heads.clone();
1289 
    let moved = vec![(p.target.clone(), state.clone(), heads.clone())];
1290 
    crate::diffusion::after_push(app, row, &moved).await;
1291 
    if p.target == row.default_bookmark {
1292 
        let (app, row) = (app.clone(), row.clone());
1293 
        tokio::spawn(async move { crate::diffusion::propagate(&app, &row, heads, false).await });
1294 
    }
1295 
    Ok(state)
1296 
}
1297
1298 
#[derive(Deserialize)]
1299 
pub struct LabelsForm {
1300 
    #[serde(rename = "_csrf")]
1301 
    csrf_token: String,
1302 
    #[serde(default)]
1303 
    label: Vec<i64>,
1304 
}
1305
1306 
pub async fn set_labels(
1307 
    State(app): State<Shared>,
1308 
    viewer: Viewer,
1309 
    Path((owner, name, number)): Path<(String, String, i64)>,
1310 
    axum_extra::extract::Form(f): axum_extra::extract::Form<LabelsForm>,
1311 
) -> Result<Response, Error> {
1312 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposal/{number}"), &viewer);
1313 
    require(&viewer, &shell)?;
1314 
    csrf(&viewer, &f.csrf_token, &shell)?;
1315 
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
1316 
    if role < Role::Triage {
1317 
        return Err(Error::not_found(shell));
1318 
    }
1319 
    let p = pdb::get(&app.db, row.id, number)
1320 
        .await
1321 
        .map_err(|e| Error::from_db(shell.clone(), e))?
1322 
        .ok_or_else(|| Error::not_found(shell.clone()))?;
1323 
    for l in db::issues::labels(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))? {
1324 
        db::issues::set_proposal_label(&app.db, p.id, l.id, f.label.contains(&l.id)).await.map_err(|e| Error::from_db(shell.clone(), e))?;
1325 
    }
1326 
    Ok(back(&owner, &name, number, "conversation", None, None))
1327 
}
1328
1329 
/// `GET /{owner}/{name}/proposal/{number}/events`: server-sent events for
1330 
/// checks on the projected state (hub spec §13.1).
1331 
pub async fn events(
1332 
    State(app): State<Shared>,
1333 
    viewer: Viewer,
1334 
    Path((owner, name, number)): Path<(String, String, i64)>,
1335 
) -> Result<axum::response::Sse<impl futures::Stream<Item = Result<axum::response::sse::Event, std::convert::Infallible>>>, Error> {
1336 
    use futures::StreamExt;
1337 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposal/{number}"), &viewer);
1338 
    let (_, row, _) = lookup(&app, &shell, &viewer, &owner, &name).await?;
1339 
    let rx = app.events.proposals.subscribe();
1340 
    let repo_id = row.id;
1341 
    let stream = tokio_stream::wrappers::BroadcastStream::new(rx).filter_map(move |item| async move {
1342 
        match item {
1343 
            Ok((id, ev)) if id == repo_id => {
1344 
                Some(Ok(axum::response::sse::Event::default().event(ev.kind.clone()).data(serde_json::to_string(&ev).unwrap_or_default())))
1345 
            }
1346 
            _ => None,
1347 
        }
1348 
    });
1349 
    Ok(axum::response::Sse::new(stream).keep_alive(axum::response::sse::KeepAlive::default()))
1350 
}
1351
1352 
// -------------------------------------------------------------------- API
1353
1354 
pub async fn to_api(app: &Shared, owner: &str, name: &str, loaded: &Loaded, v: &Verdict, source_url: Option<String>) -> hub_api::Proposal {
1355 
    let p = &loaded.row;
1356 
    hub_api::Proposal {
1357 
        number: p.number,
1358 
        title: p.title.clone(),
1359 
        body: p.body.clone(),
1360 
        author: p.author.clone(),
1361 
        state: ProposalState::parse(&p.state).unwrap_or(ProposalState::Open),
1362 
        target: p.target.clone(),
1363 
        source: match p.source_kind.as_str() {
1364 
            "fork" => {
1365 
                let (o, n) = source_url
1366 
                    .as_deref()
1367 
                    .and_then(|u| u.rsplit_once('/'))
1368 
                    .and_then(|(b, n)| b.rsplit_once('/').map(|(_, o)| (o.to_string(), n.to_string())))
1369 
                    .unwrap_or_default();
1370 
                ProposalSource::Fork { owner: o, name: n, bookmark: p.source_bookmark.clone() }
1371 
            }
1372 
            "changes" => ProposalSource::Changes { hashes: p.source_changes() },
1373 
            _ => ProposalSource::Bookmark { bookmark: p.source_bookmark.clone() },
1374 
        },
1375 
        changes: loaded
1376 
            .changes
1377 
            .iter()
1378 
            .map(|c| hub_api::ChangeSummary {
1379 
                hash: c.hash.clone(),
1380 
                message: if c.body.is_empty() { c.title.clone() } else { format!("{}\n\n{}", c.title, c.body) },
1381 
                author: hub_api::Author {
1382 
                    name: c.author.name.clone(),
1383 
                    email: c.author.email.clone(),
1384 
                    key: c.author.key.clone(),
1385 
                    account: c.author.account.clone(),
1386 
                    note: hub_api::Author::note_for(&c.author.key, &c.author.account),
1387 
                },
1388 
                when_ms: c.when_ms,
1389 
                deps: c.deps.clone(),
1390 
                head: c.head,
1391 
                via: c.via.as_ref().map(|v| hub_api::Via {
1392 
                    name: v.name.clone(),
1393 
                    key: v.key.clone(),
1394 
                    scope: v.scope.clone(),
1395 
                    expires_ms: v.expires_ms,
1396 
                    revoked: v.revoked,
1397 
                }),
1398 
                signature: match &c.signature {
1399 
                    view::SigView::Unsigned => hub_api::Signature::Unsigned,
1400 
                    view::SigView::Valid { key, sealed, revoked, .. } => {
1401 
                        hub_api::Signature::Valid { key: key.clone(), sealed: *sealed, revoked: *revoked }
1402 
                    }
1403 
                    view::SigView::Invalid(why) => hub_api::Signature::Invalid { reason: why.clone() },
1404 
                },
1405 
            })
1406 
            .collect(),
1407 
        projected_heads: loaded.heads.iter().map(|h| h.to_hex()).collect(),
1408 
        projected_state: Some(loaded.state.clone()),
1409 
        conflicted: loaded.conflicted,
1410 
        approvals: v.approvals.clone(),
1411 
        landable: p.is_open() && v.blockers.is_empty(),
1412 
        blockers: v.blockers.clone(),
1413 
        created_ms: p.created_ms,
1414 
        updated_ms: p.updated_ms,
1415 
        url: format!("{}/{owner}/{name}/proposal/{}", app.config.base_url(), p.number),
1416 
        repository_url: format!("{}/{owner}/{name}", app.config.base_url()),
1417 
        source_url,
1418 
        landed: (p.state == "landed" && p.landed_ms > 0).then(|| hub_api::Landed {
1419 
            by: p.landed_by.clone(),
1420 
            via: p.landed_via.clone(),
1421 
            when_ms: p.landed_ms,
1422 
        }),
1423 
        requested_reviewers: pdb::review_requests(&app.db, p.id).await.unwrap_or_default(),
1424 
        labels: db::issues::proposal_labels(&app.db, p.id)
1425 
            .await
1426 
            .unwrap_or_default()
1427 
            .into_iter()
1428 
            .map(|l| hub_api::Label { name: l.name, colour: l.colour, description: l.description })
1429 
            .collect(),
1430 
    }
1431 
}
1432
1433 
/// The line comment form's placement key, for templates.
1434 
pub fn key(path: &str, line: impl filters::Num) -> (String, usize) {
1435 
    (path.to_string(), line.as_u64() as usize)
1436 
}
1437
1438 
#[allow(dead_code)]
1439 
fn _unused(_: &diff::Line, _: &ConflictView, _: &Role) {}
1440
1441 
// ------------------------------------------------------- review requests
1442
1443 
/// Ask accounts to review a proposal (hub plan 0.4): each must exist, be
1444 
/// someone other than the author, and be able to read the repository. Each
1445 
/// newly asked is told, and the proposal records it. The usernames newly
1446 
/// asked, or why none could be.
1447 
pub async fn request_reviewers(
1448 
    app: &Shared,
1449 
    row: &db::repos::RepoRow,
1450 
    p: &pdb::ProposalRow,
1451 
    by: &accounts::Account,
1452 
    names: &[String],
1453 
) -> Result<Vec<String>, String> {
1454 
    let mut found = Vec::new();
1455 
    for name in names.iter().map(|n| n.trim().trim_start_matches('@')).filter(|n| !n.is_empty()) {
1456 
        let Some(a) = accounts::account_by_name(&app.db, name).await.ok().flatten() else {
1457 
            return Err(format!("There is no account {name}."));
1458 
        };
1459 
        if Some(a.id) == p.author_id {
1460 
            return Err(format!("{name} wrote this proposal, and cannot review it."));
1461 
        }
1462 
        let role = crate::auth::roles::role_for(&app.db, Some(&a), row).await.ok().flatten();
1463 
        if !crate::auth::roles::allows(role, crate::auth::Access::Read) {
1464 
            return Err(format!("{name} cannot read this repository."));
1465 
        }
1466 
        found.push(a);
1467 
    }
1468 
    let mut asked = Vec::new();
1469 
    for a in found {
1470 
        if !pdb::request_review(&app.db, p.id, a.id, &by.username).await.map_err(|e| e.to_string())? {
1471 
            continue;
1472 
        }
1473 
        pdb::add_event(&app.db, p.id, &by.username, "review requested", &a.username).await.ok();
1474 
        crate::notify::deliver(
1475 
            app,
1476 
            crate::notify::Event {
1477 
                kind: "proposal.review_requested",
1478 
                title: format!("{}/{}#{}: {} (review requested from {})", row.owner, row.name, p.number, p.title, a.username),
1479 
                url: format!("/{}/{}/proposal/{}", row.owner, row.name, p.number),
1480 
                actor: by,
1481 
                repo_id: row.id,
1482 
                thread: None,
1483 
                mention_text: "",
1484 
                direct: vec![a.id],
1485 
            },
1486 
        )
1487 
        .await;
1488 
        asked.push(a.username);
1489 
    }
1490 
    Ok(asked)
1491 
}
1492
1493 
/// After a review: it answers the reviewer's request, if there was one, and
1494 
/// the proposal's author is told.
1495 
pub async fn reviewed(app: &Shared, row: &db::repos::RepoRow, p: &pdb::ProposalRow, by: &accounts::Account, verdict: &str) {
1496 
    pdb::unrequest_review(&app.db, p.id, by.id).await.ok();
1497 
    let what = match verdict {
1498 
        "approve" => "approved",
1499 
        "changes" => "changes requested",
1500 
        _ => "reviewed",
1501 
    };
1502 
    crate::notify::deliver(
1503 
        app,
1504 
        crate::notify::Event {
1505 
            kind: "proposal.review",
1506 
            title: format!("{}/{}#{}: {} ({what} by {})", row.owner, row.name, p.number, p.title, by.username),
1507 
            url: format!("/{}/{}/proposal/{}", row.owner, row.name, p.number),
1508 
            actor: by,
1509 
            repo_id: row.id,
1510 
            thread: Some(("proposal", p.id)),
1511 
            mention_text: "",
1512 
            direct: p.author_id.into_iter().collect(),
1513 
        },
1514 
    )
1515 
    .await;
1516 
}
1517
1518 
#[derive(Deserialize)]
1519 
pub struct ReviewersForm {
1520 
    #[serde(rename = "_csrf")]
1521 
    csrf_token: String,
1522 
    /// `add`, `remove`, or `set` (the menu: exactly these are asked).
1523 
    action: String,
1524 
    #[serde(default)]
1525 
    username: Vec<String>,
1526 
}
1527
1528 
/// `POST /{owner}/{name}/proposal/{number}/reviewers`: the author or a
1529 
/// writer asks someone to review, or withdraws the request.
1530 
pub async fn reviewers(
1531 
    State(app): State<Shared>,
1532 
    viewer: Viewer,
1533 
    Path((owner, name, number)): Path<(String, String, i64)>,
1534 
    axum_extra::extract::Form(f): axum_extra::extract::Form<ReviewersForm>,
1535 
) -> Result<Response, Error> {
1536 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposal/{number}"), &viewer);
1537 
    let me = require(&viewer, &shell)?;
1538 
    csrf(&viewer, &f.csrf_token, &shell)?;
1539 
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
1540 
    let p = pdb::get(&app.db, row.id, number)
1541 
        .await
1542 
        .map_err(|e| Error::from_db(shell.clone(), e))?
1543 
        .ok_or_else(|| Error::not_found(shell.clone()))?;
1544 
    if Some(me.account.id) != p.author_id && role < Role::Write {
1545 
        return Err(Error::not_found(shell));
1546 
    }
1547 
    let names: Vec<String> = f.username.iter().map(|n| n.trim().trim_start_matches('@').to_string()).filter(|n| !n.is_empty()).collect();
1548 
    let current = pdb::review_requests(&app.db, p.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
1549 
    // Withdrawn: those named (remove), or those the menu left out (set).
1550 
    let withdraw: Vec<String> = match f.action.as_str() {
1551 
        "remove" => names.clone(),
1552 
        "set" => current.iter().filter(|c| !names.iter().any(|n| n.eq_ignore_ascii_case(c))).cloned().collect(),
1553 
        _ => Vec::new(),
1554 
    };
1555 
    for who in &withdraw {
1556 
        if let Some(a) = accounts::account_by_name(&app.db, who).await.ok().flatten() {
1557 
            if pdb::unrequest_review(&app.db, p.id, a.id).await.map_err(|e| Error::from_db(shell.clone(), e))? {
1558 
                pdb::add_event(&app.db, p.id, &me.account.username, "review request withdrawn", &a.username).await.ok();
1559 
            }
1560 
        }
1561 
    }
1562 
    let ask: Vec<String> = match f.action.as_str() {
1563 
        "add" => names,
1564 
        "set" => names.into_iter().filter(|n| !current.iter().any(|c| c.eq_ignore_ascii_case(n))).collect(),
1565 
        _ => return Ok(back(&owner, &name, number, "conversation", None, None)),
1566 
    };
1567 
    if ask.is_empty() {
1568 
        return Ok(back(&owner, &name, number, "conversation", None, None));
1569 
    }
1570 
    match request_reviewers(&app, &row, &p, &me.account, &ask).await {
1571 
        Ok(asked) if asked.is_empty() => Ok(back(&owner, &name, number, "conversation", Some("Already asked.".into()), None)),
1572 
        Ok(asked) => Ok(back(&owner, &name, number, "conversation", Some(format!("Asked {} to review.", asked.join(", "))), None)),
1573 
        Err(e) => Ok(back(&owner, &name, number, "conversation", None, Some(e))),
1574 
    }
1575 
}
1576
1577 
#[derive(Deserialize)]
1578 
pub struct AssistantForm {
1579 
    #[serde(rename = "_csrf")]
1580 
    csrf_token: String,
1581 
    assistant: String,
1582 
    /// `summary` asks for a summary comment (oxygenhub#190); otherwise a review.
1583 
    #[serde(default)]
1584 
    task: String,
1585 
}
1586
1587 
/// `POST /{owner}/{name}/proposal/{number}/assistant`: the author or a
1588 
/// writer asks an AI assistant to review (hub spec §13.4). The answer
1589 
/// comes later as a review via the assistant.
1590 
pub async fn assistant(
1591 
    State(app): State<Shared>,
1592 
    viewer: Viewer,
1593 
    Path((owner, name, number)): Path<(String, String, i64)>,
1594 
    Form(f): Form<AssistantForm>,
1595 
) -> Result<Response, Error> {
1596 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposal/{number}"), &viewer);
1597 
    let me = require(&viewer, &shell)?;
1598 
    csrf(&viewer, &f.csrf_token, &shell)?;
1599 
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
1600 
    super::writable(&row, &shell)?;
1601 
    let p = pdb::get(&app.db, row.id, number)
1602 
        .await
1603 
        .map_err(|e| Error::from_db(shell.clone(), e))?
1604 
        .ok_or_else(|| Error::not_found(shell.clone()))?;
1605 
    if Some(me.account.id) != p.author_id && role < Role::Write {
1606 
        return Err(Error::not_found(shell));
1607 
    }
1608 
    if !p.is_open() {
1609 
        return Ok(back(&owner, &name, number, "conversation", None, Some("The proposal is not open.".into())));
1610 
    }
1611 
    let Some(a) = crate::assistants::enabled_for_repo(&app.db, &row)
1612 
        .await
1613 
        .map_err(|e| Error::from_db(shell.clone(), e))?
1614 
        .into_iter()
1615 
        .find(|a| a.name.eq_ignore_ascii_case(f.assistant.trim()))
1616 
    else {
1617 
        return Ok(back(&owner, &name, number, "conversation", None, Some(format!("No assistant called {} here.", f.assistant.trim()))));
1618 
    };
1619 
    let who = a.name.clone();
1620 
    let summary = f.task == "summary";
1621 
    let asked = if summary {
1622 
        crate::assistants::request_summary(&app, &row, &p, &me.account, a).await
1623 
    } else {
1624 
        crate::assistants::request_review(&app, &row, &p, &me.account, a).await
1625 
    };
1626 
    match asked {
1627 
        Ok(()) => Ok(back(
1628 
            &owner,
1629 
            &name,
1630 
            number,
1631 
            "conversation",
1632 
            Some(if summary {
1633 
                format!("Asked {who} for a summary; its comment appears here when it comes.")
1634 
            } else {
1635 
                format!("Asked {who} to review; its answer appears here when it comes.")
1636 
            }),
1637 
            None,
1638 
        )),
1639 
        Err(e) => Ok(back(&owner, &name, number, "conversation", None, Some(format!("Not asked: {e}.")))),
1640 
    }
1641 
}
1642
1643 
/// The assistants a repository may use, by name.
1644 
async fn assistant_names(app: &Shared, row: &db::repos::RepoRow) -> Vec<String> {
1645 
    crate::assistants::enabled_for_repo(&app.db, row).await.unwrap_or_default().into_iter().map(|a| a.name).collect()
1646 
}
1647
1648 
/// The changes and the file diffs a proposal from `source` into `target`
1649 
/// would carry.
1650 
async fn preview_diff(
1651 
    app: &Shared,
1652 
    repo: &RepoName,
1653 
    target: &str,
1654 
    source: &str,
1655 
) -> Result<(Vec<ChangeView>, Vec<oxy_core::repo::FileDiff>), crate::repos::RepoError> {
1656 
    let Some((fork, bookmark)) = parse_source(app, repo, source) else { return Ok((vec![], vec![])) };
1657 
    let target = target.to_string();
1658 
    let fork_dir = fork.as_ref().map(|f| app.repos.dir(f));
1659 
    app.repos
1660 
        .read(repo, move |r, cache| {
1661 
            let projection = match &fork_dir {
1662 
                Some(dir) => {
1663 
                    let fork_repo = oxy_core::repo::Repo::open(dir)?;
1664 
                    let heads = fork_repo.bookmarks()?.into_iter().find(|b| b.name == bookmark).map(|b| b.heads).unwrap_or_default();
1665 
                    pl::project(r, cache, &target, Source::Fork { fork: &fork_repo, heads })?
1666 
                }
1667 
                None => {
1668 
                    let heads = r.bookmarks()?.into_iter().find(|b| b.name == bookmark).map(|b| b.heads).unwrap_or_default();
1669 
                    pl::project(r, cache, &target, Source::Bookmark(heads))?
1670 
                }
1671 
            };
1672 
            Ok((projection.changes, projection.files))
1673 
        })
1674 
        .await
1675 
}
1676
1677 
/// `POST /{owner}/{name}/proposals/new/draft`: an assistant drafts the
1678 
/// description from the changes the proposal would add; the form comes
1679 
/// back with the draft to edit (hub spec §13.4).
1680 
pub async fn new_draft(
1681 
    State(app): State<Shared>,
1682 
    viewer: Viewer,
1683 
    Path((owner, name)): Path<(String, String)>,
1684 
    Form(f): Form<NewForm>,
1685 
) -> Result<Page<NewProposalPage>, Error> {
1686 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposals/new"), &viewer);
1687 
    let me = require(&viewer, &shell)?;
1688 
    csrf(&viewer, &f.csrf_token, &shell)?;
1689 
    let (repo, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
1690 
    super::writable(&row, &shell)?;
1691 
    let bookmarks =
1692 
        app.repos.read(&repo, |r, _| Ok(r.bookmarks()?.into_iter().map(|b| b.name).collect::<Vec<_>>())).await.unwrap_or_default();
1693 
    let (preview, conflicted) = preview_for(&app, &repo, &f.target, &f.source).await.unwrap_or((vec![], false));
1694 
    let assistants = if preview.is_empty() { vec![] } else { assistant_names(&app, &row).await };
1695 
    let mut page = NewProposalPage {
1696 
        shell,
1697 
        repo: RepoShell::new(&app, &row, "proposals").with_role(role),
1698 
        bookmarks,
1699 
        source: f.source.clone(),
1700 
        target: f.target.clone(),
1701 
        error: None,
1702 
        preview,
1703 
        conflicted,
1704 
        title: f.title.clone(),
1705 
        body: f.body.clone(),
1706 
        assistants,
1707 
    };
1708 
    let assistant = crate::assistants::enabled_for_repo(&app.db, &row)
1709 
        .await
1710 
        .unwrap_or_default()
1711 
        .into_iter()
1712 
        .find(|a| a.name.eq_ignore_ascii_case(f.assistant.trim()));
1713 
    let Some(a) = assistant else {
1714 
        page.error = Some(format!("No assistant called {} here.", f.assistant.trim()));
1715 
        return Ok(Page(page));
1716 
    };
1717 
    if page.preview.is_empty() {
1718 
        page.error = Some("Nothing to describe: the source adds nothing to the target.".into());
1719 
        return Ok(Page(page));
1720 
    }
1721 
    let (changes, diffs) = match preview_diff(&app, &repo, &f.target, &f.source).await {
1722 
        Ok(x) => x,
1723 
        Err(e) => {
1724 
            page.error = Some(e.to_string());
1725 
            return Ok(Page(page));
1726 
        }
1727 
    };
1728 
    let d = crate::assistants::Draft { slot: -row.id, title: &f.title, target: &f.target, changes: &changes, diffs: &diffs };
1729 
    match crate::assistants::draft_description(&app, &row, &me.account, &a, d).await {
1730 
        Ok(text) => page.body = text,
1731 
        Err(why) => page.error = Some(format!("{} did not answer: {why}.", a.name)),
1732 
    }
1733 
    Ok(Page(page))
1734 
}
1735
1736 
#[derive(Deserialize)]
1737 
pub struct DraftForm {
1738 
    #[serde(rename = "_csrf")]
1739 
    csrf_token: String,
1740 
    assistant: String,
1741 
    #[serde(default)]
1742 
    title: String,
1743 
}
1744
1745 
/// `POST /{owner}/{name}/proposal/{number}/draft`: an assistant drafts the
1746 
/// description of an open proposal from its changes; the editor opens
1747 
/// with the draft, nothing is saved (hub spec §13.4).
1748 
pub async fn draft(
1749 
    State(app): State<Shared>,
1750 
    viewer: Viewer,
1751 
    Path((owner, name, number)): Path<(String, String, i64)>,
1752 
    Form(f): Form<DraftForm>,
1753 
) -> Result<Response, Error> {
1754 
    let shell = Shell::new(&app, &format!("/{owner}/{name}/proposal/{number}"), &viewer);
1755 
    let me = require(&viewer, &shell)?;
1756 
    csrf(&viewer, &f.csrf_token, &shell)?;
1757 
    let (repo, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
1758 
    super::writable(&row, &shell)?;
1759 
    let p = pdb::get(&app.db, row.id, number)
1760 
        .await
1761 
        .map_err(|e| Error::from_db(shell.clone(), e))?
1762 
        .ok_or_else(|| Error::not_found(shell.clone()))?;
1763 
    if Some(me.account.id) != p.author_id && role < Role::Maintain {
1764 
        return Err(Error::not_found(shell));
1765 
    }
1766 
    let Some(a) = crate::assistants::enabled_for_repo(&app.db, &row)
1767 
        .await
1768 
        .map_err(|e| Error::from_db(shell.clone(), e))?
1769 
        .into_iter()
1770 
        .find(|a| a.name.eq_ignore_ascii_case(f.assistant.trim()))
1771 
    else {
1772 
        return Ok(back(&owner, &name, number, "conversation", None, Some(format!("No assistant called {} here.", f.assistant.trim()))));
1773 
    };
1774 
    let loaded = crate::web::proposals::load(&app, &repo, p.clone()).await.map_err(|e| Error::from_repo(shell.clone(), e))?;
1775 
    let title = if f.title.trim().is_empty() { p.title.clone() } else { f.title.clone() };
1776 
    let d = crate::assistants::Draft { slot: p.id, title: &title, target: &p.target, changes: &loaded.changes, diffs: &loaded.diffs };
1777 
    let draft = crate::assistants::draft_description(&app, &row, &me.account, &a, d).await;
1778 
    match draft {
1779 
        Ok(text) => {
1780 
            let mut page = detail(&app, shell, &viewer, &owner, &name, number, "conversation".into(), None, None).await?;
1781 
            page.0.draft = Some(text);
1782 
            Ok(page.into_response())
1783 
        }
1784 
        Err(why) => Ok(back(&owner, &name, number, "conversation", None, Some(format!("{} did not answer: {why}.", a.name)))),
1785 
    }
1786 
}