[AlbertMcAvoy]

Stacked on #59 (GitLab): it reuses the news card and the scrolling list that #59 brings. Until #59 is merged, the diff here also shows #59's commits; the YouTrack part is the last commit.

What it does

Adds a YouTrack pill to the Windows island, for a self-hosted instance. It follows one saved search that you pick in the settings, and notifies you when an issue of that search is:

• created by someone else: "Created by Ada: APP-12 Login page loops";
• updated by someone else (a field, a comment, a link…): "Updated by Ada: APP-12 Login page loops".

Your own changes don't notify you: they already happened in front of you.

Everything new in the same minute arrives as one notification, like GitLab's: one sound, one badge, "N YouTrack updates" with the list, and the same news card as GitLab's, with a pink Mochi.

The card lists the search's issues, five rows on screen and the rest a scroll away:

1. the last half hour's news, highlighted;
2. then the search's issues, most recently updated first. Resolved ones are grey.

Every row opens its issue. "N issues" opens the search in YouTrack, and ↗ / "Open YouTrack" open the instance. The overview grows to 210 px while this card is shown, as it does for GitLab's.

Read-only: Coucou never changes an issue.

Setup

Settings → Integrations → YouTrack:

• Instance URL: https://host or https://host/youtrack. Only http(s):// is accepted.
• Permanent token: created in YouTrack under Profile → Account Security → Tokens.
• Saved search: a list loaded from the instance once the URL and the token are saved, with your own searches first, then those shared with you. It reloads when either changes, and has a Reload button.

The three values live in the Windows Credential Manager, like GitLab's. Nothing is polled until the token exists and the pill is switched on, and Pause stops it like the others. Picking a search refreshes the pill right away, only if it is switched on.

How

• poll_youtrack in integrations.rs runs every 60 s and makes 3 requests:
  • users/me (checks the URL and the token, and gives your login);
  • savedQueries/{id}, the followed search's text;
  • issues?query=…, its 50 most recently updated issues.
• The search is run without its own sort by: clause, and sorted by updated desc instead. Otherwise a search sorted by priority would decide which 50 issues are read, and recent changes could fall outside them.
• What's new is a pure function, youtrack_fresh, with tests.
  • It remembers the latest updated it saw. An issue above it is news: "Created" if its created is above it too, "Updated" otherwise.
  • Who did it is the reporter or the updater. If that's you, it isn't news.
  • The first answer primes it, so launching Coucou says nothing. Picking another saved search starts afresh, silently.
• The saved search id goes into a URL path, so only [A-Za-z0-9._-] is accepted.
• Errors show on the card: invalid token (401), no access (403), not a YouTrack address (404 on users/me), saved search gone (404), a search YouTrack can't run (400), no connection. As for GitLab, the connection error is printed without the URL.
• Shared with GitLab: the news card (buildNews), Mochi taking the integration's colour on it (NEWS_VIEWS), and the half-hour news bookkeeping (recent_news, news_event). GitLab's behaviour is unchanged, and its tests still pass.
• No Cargo change.

Testing

Windows 11 (build 26200).

• cargo test -p coucou passes with no new warnings, and tsc is clean. New tests cover:
  • the first answer is silent, then an issue created by someone else and one updated by someone else are told, but not the user's own change, nor an older issue that only entered the list;
  • picking another saved search starts afresh, and drops the old search's news;
  • the search loses its own sort by: / order by: clause, and non-ASCII text survives the cut.
• The request shapes were checked against a public YouTrack instance: the issue fields, savedQueries, and the 404 of a deleted saved search.
• The card was rendered with sample data: five rows on screen, the rest scrolling, news on top.
• Checked against a live self-hosted YouTrack: the saved search list, the card, scrolling, and your own change not notifying
• Checked against a live self-hosted YouTrack: an issue created and one updated by someone else each notify once

Screenshot