whose-turn 0.0.0-stage → 1.0.0-alpha.2

package/connectors/github.mjs

@@ -0,0 +1,316 @@
+/** GitHub connector: your PRs in one repository with reviews, comments and checks, the workflow runs on its default branch, plus review requests and mentions across the org. Token from `GH_TOKEN`, else `gh auth token`. */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { RateLimited } from '../lib/http-client.mjs';
+import { oneline, nowIso, mapLimit, wordsRegex, DAY } from '../lib/text.mjs';
+import { cachedToken } from '../lib/token-cache.mjs';
+
+const run = promisify(execFile);
+const API = 'https://api.github.com';
+
+export const id = 'github';
+export const label = 'GitHub';
+export const links = (settings) => (settings.repo ? [{ label: 'GitHub', url: `https://github.com/${settings.repo}` }] : []);
+export const fields = [
+  { key: 'repo', label: 'Repository', hint: 'owner/name whose PRs are yours', required: true },
+  { key: 'org', label: 'Organisation', hint: 'notifications are kept only from this org; defaults to the repository owner' },
+  { key: 'me', label: 'Your login', hint: 'left empty, it is asked from the API once' },
+  { key: 'account', label: 'gh account', hint: 'which logged-in gh account to use' },
+  { key: 'bots', label: 'Bot logins', hint: 'comma-separated; their comments never count as a reply', list: true },
+  { key: 'workflow_runs', label: 'Workflow runs', hint: 'watch the Actions runs on the default branch; on unless set to false', boolean: true, default: true },
+];
+
+export const persistedCache = ['prs', 'asks', 'runStreaks'];
+
+/** `GH_TOKEN` when set (CI, a machine without gh), else the token gh holds. */
+const ghToken = (account, cache) => cachedToken(cache, async () => {
+  if (process.env.GH_TOKEN) {
+    return process.env.GH_TOKEN;
+  }
+  const { stdout } = await run('gh', account ? ['auth', 'token', '--user', account] : ['auth', 'token']);
+  return stdout.trim();
+});
+
+const createApi = (http, token) => (path) => {
+  const url = path.startsWith(API) ? path : `${API}${path}`;
+  if (!url.startsWith(`${API}/`)) {
+    throw new Error(`Refusing to send the GitHub token to ${url}`);
+  }
+  return http.fetchJson(url, { headers: { Authorization: `Bearer ${token}`, Accept: 'application/vnd.github+json', 'X-GitHub-Api-Version': '2022-11-28' } });
+};
+
+const checksFor = async (api, repo, sha) => {
+  const runs = (await api(`/repos/${repo}/commits/${sha}/check-runs?per_page=100`)).check_runs || [];
+  const conclusions = runs.map((checkRun) => checkRun.conclusion || checkRun.status);
+  let state = 'passing';
+  if (conclusions.some((value) => ['failure', 'timed_out', 'cancelled', 'action_required'].includes(value))) {
+    state = 'failing';
+  } else if (conclusions.some((value) => ['queued', 'in_progress', 'pending', 'waiting', null, undefined].includes(value))) {
+    state = 'running';
+  } else if (!runs.length) {
+    state = 'none';
+  }
+  const failed = runs.filter((checkRun) => ['failure', 'timed_out'].includes(checkRun.conclusion));
+  return { state, failed };
+};
+
+const reviewDecision = (reviews) => {
+  const latest = {};
+  for (const review of reviews) {
+    if (['APPROVED', 'CHANGES_REQUESTED', 'DISMISSED'].includes(review.state)) {
+      latest[review.user.login] = review.state;
+    }
+  }
+  const values = new Set(Object.values(latest));
+  if (values.has('CHANGES_REQUESTED')) {
+    return 'CHANGES_REQUESTED';
+  }
+  return values.has('APPROVED') ? 'APPROVED' : '';
+};
+
+/** A PR's reference in the feed: the repository name and the number, so a PR without a ticket still says where it lives (RMA-167). */
+const prRef = (repo, number) => `${repo.split('/').pop()}#${number}`;
+
+const failedCheckActivity = (checkRun, { pr, key, title }) => ({ at: checkRun.completed_at || nowIso(), pr, key, title, kind: 'check failed', who: checkRun.name, url: checkRun.html_url, text: '', body: '' });
+
+const buildPr = async (api, { repo, me, bots, keyOf, sinceIso }, number) => {
+  const [pr, issueComments, inlineComments, reviews] = await Promise.all([
+    api(`/repos/${repo}/pulls/${number}`),
+    api(`/repos/${repo}/issues/${number}/comments?per_page=100`),
+    api(`/repos/${repo}/pulls/${number}/comments?per_page=100`),
+    api(`/repos/${repo}/pulls/${number}/reviews?per_page=100`),
+  ]);
+  const state = pr.merged_at ? 'MERGED' : pr.state.toUpperCase();
+  const checks = await checksFor(api, repo, pr.head.sha);
+  const human = [];
+  for (const comment of issueComments) {
+    human.push({ who: comment.user.login, at: comment.created_at, url: comment.html_url, kind: 'comment', body: comment.body || '', state: '' });
+  }
+  for (const comment of inlineComments) {
+    human.push({ who: comment.user.login, at: comment.created_at, url: comment.html_url, kind: 'inline comment', body: comment.body || '', state: '' });
+  }
+  for (const review of reviews) {
+    if (review.state === 'COMMENTED' && !review.body) {
+      continue;
+    }
+    human.push({ who: review.user.login, at: review.submitted_at || '', url: review.html_url, kind: review.state.toLowerCase().replace(/_/g, ' '), body: review.body || '', state: review.state });
+  }
+  const people = human.filter((item) => !bots.test(item.who) && item.at).sort((a, b) => a.at.localeCompare(b.at));
+  const others = people.filter((item) => item.who !== me);
+  const mine = people.filter((item) => item.who === me);
+  const last = others[others.length - 1];
+  const myLast = mine.length ? mine[mine.length - 1].at : '';
+  const key = keyOf(pr.title);
+  const subject = { pr: prRef(repo, number), key, title: pr.title };
+  const row = {
+    pr: number, key, title: pr.title, base: pr.base.ref, state, review: reviewDecision(reviews), checks: checks.state, merged_at: pr.merged_at || '',
+    updated_at: pr.updated_at, url: pr.html_url,
+    last_comment_by: last ? last.who : '', last_comment_at: last ? last.at : '', last_comment_url: last ? last.url : '', last_comment: last ? oneline(last.body, 160) : '',
+    unanswered: Boolean(last && state === 'OPEN' && last.state !== 'APPROVED' && last.at > myLast),
+  };
+  const activity = people.filter((item) => item.at >= sinceIso).map((item) => ({
+    ...subject, at: item.at, kind: item.kind, who: item.who === me ? 'you' : item.who, url: item.url, text: oneline(item.body), body: item.body.replace(/\r/g, '').slice(0, 6000),
+  }));
+  for (const checkRun of checks.failed) {
+    if ((checkRun.completed_at || '') >= sinceIso) {
+      activity.push(failedCheckActivity(checkRun, subject));
+    }
+  }
+  if (pr.merged_at && pr.merged_at >= sinceIso) {
+    activity.push({ ...subject, at: pr.merged_at, kind: 'merged', who: '', url: pr.html_url, text: '', body: '' });
+  }
+  return { row, activity, sha: pr.head.sha };
+};
+
+const refreshChecks = async (api, repo, cached, number) => {
+  const checks = await checksFor(api, repo, cached.sha);
+  if (checks.state === cached.row.checks) {
+    return;
+  }
+  cached.row.checks = checks.state;
+  for (const checkRun of checks.failed) {
+    const item = failedCheckActivity(checkRun, { pr: prRef(repo, number), key: cached.row.key, title: cached.row.title });
+    if (!cached.activity.some((existing) => existing.url === item.url && existing.at === item.at)) {
+      cached.activity.push(item);
+    }
+  }
+};
+
+const pollPrs = async (api, context) => {
+  const { repo, me, sinceIso, cache } = context;
+  const since = sinceIso.slice(0, 10);
+  const found = new Map();
+  const queries = [`repo:${repo} is:pr author:${me} is:open`, `repo:${repo} is:pr author:${me} updated:>=${since}`];
+  const searches = await Promise.all(queries.map((query) => api(`/search/issues?q=${encodeURIComponent(query)}&per_page=50`)));
+  for (const item of searches.flatMap((result) => result.items || [])) {
+    found.set(item.number, item.updated_at);
+  }
+  cache.prs = cache.prs || new Map();
+  const unchanged = [...found].filter(([number, updatedAt]) => cache.prs.get(number)?.updated_at === updatedAt).map(([number]) => number);
+  const changed = [...found].filter(([number]) => !unchanged.includes(number));
+  await mapLimit(unchanged.filter((number) => cache.prs.get(number).row.state === 'OPEN'), 4, (number) => refreshChecks(api, repo, cache.prs.get(number), number));
+  await mapLimit(changed, 4, async ([number, updatedAt]) => {
+    cache.prs.set(number, { updated_at: updatedAt, ...(await buildPr(api, context, number)) });
+  });
+  for (const number of [...cache.prs.keys()]) {
+    if (!found.has(number)) {
+      cache.prs.delete(number);
+    }
+  }
+  const prs = [...cache.prs.values()].map((entry) => entry.row).sort((a, b) => a.pr - b.pr);
+  const activity = [...cache.prs.values()].flatMap((entry) => entry.activity).filter((item) => item.at >= sinceIso).sort((a, b) => b.at.localeCompare(a.at));
+  return { prs, activity };
+};
+
+const RUN_FAILED = ['failure', 'timed_out', 'startup_failure'];
+const RUN_PASSED = ['success'];
+
+/** A workflow run's reference in the feed and the key of its row: repository name, workflow and branch (RMA-152). */
+const runRef = (repo, workflow, branch) => `${repo.split('/').pop()}:${workflow}@${branch}`;
+
+const defaultBranch = async (api, repo, cache) => {
+  if (!cache.defaultBranch || Date.now() - cache.defaultBranchAt > DAY) {
+    cache.defaultBranch = (await api(`/repos/${repo}`)).default_branch;
+    cache.defaultBranchAt = Date.now();
+  }
+  return cache.defaultBranch;
+};
+
+/** The completed runs on the default branch, newest first per workflow; pull request runs are left to the PR path. */
+const runsByWorkflow = (listed, branch) => {
+  const byWorkflow = new Map();
+  const decided = listed.filter((run) => run.head_branch === branch && !String(run.event).startsWith('pull_request') && !(run.pull_requests || []).length
+    && run.status === 'completed' && [...RUN_FAILED, ...RUN_PASSED].includes(run.conclusion));
+  for (const run of decided.sort((a, b) => b.created_at.localeCompare(a.created_at))) {
+    (byWorkflow.get(run.workflow_id) || byWorkflow.set(run.workflow_id, []).get(run.workflow_id)).push(run);
+  }
+  return byWorkflow;
+};
+
+/** The first failure of the newest unbroken failure streak; a streak longer than the page keeps the start seen on an earlier poll. */
+const streakStart = (runs, ref, cache) => {
+  const passedAt = runs.findIndex((run) => RUN_PASSED.includes(run.conclusion));
+  const failures = passedAt < 0 ? runs : runs.slice(0, passedAt);
+  const start = passedAt < 0 && cache.runStreaks.has(ref) ? cache.runStreaks.get(ref) : failures[failures.length - 1].id;
+  cache.runStreaks.set(ref, start);
+  return start;
+};
+
+const pollRuns = async (api, { repo, me, sinceIso, cache }) => {
+  const branch = await defaultBranch(api, repo, cache);
+  const listed = (await api(`/repos/${repo}/actions/runs?branch=${encodeURIComponent(branch)}&per_page=50`)).workflow_runs || [];
+  cache.runStreaks = cache.runStreaks || new Map();
+  const runs = [];
+  const activity = [];
+  for (const workflowRuns of runsByWorkflow(listed, branch).values()) {
+    const ref = runRef(repo, workflowRuns[0].name, branch);
+    workflowRuns.forEach((run, index) => {
+      const failed = RUN_FAILED.includes(run.conclusion);
+      const recovered = !failed && RUN_FAILED.includes(workflowRuns[index + 1]?.conclusion);
+      if ((failed || recovered) && run.updated_at >= sinceIso) {
+        activity.push({ at: run.updated_at, pr: ref, key: '', title: run.display_title || '', kind: failed ? 'check failed' : 'check passed', who: run.name, url: run.html_url, text: `${run.name} on ${branch}`, body: '' });
+      }
+    });
+    const latest = workflowRuns[0];
+    if (!RUN_FAILED.includes(latest.conclusion)) {
+      cache.runStreaks.delete(ref);
+      continue;
+    }
+    runs.push({
+      id: latest.id, ref, repo, workflow: latest.name, branch, failed: true, mine: [latest.actor?.login, latest.triggering_actor?.login].includes(me),
+      actor: latest.actor?.login || '', title: latest.display_title || '', url: latest.html_url, at: latest.updated_at, streak: streakStart(workflowRuns, ref, cache),
+    });
+  }
+  return { runs, activity };
+};
+
+const issueNumber = (apiUrl) => {
+  const match = /\/(pulls|issues)\/(\d+)$/.exec(apiUrl || '');
+  return match ? Number(match[2]) : null;
+};
+
+const buildAsk = async (api, { me, keyOf }, note, repo) => {
+  const subject = note.subject;
+  const number = issueNumber(subject.url);
+  if (!number) {
+    return null;
+  }
+  const title = subject.title || '';
+  const base = { repo, number, ref: prRef(repo, number), title, key: keyOf(title), url: `https://github.com/${repo}/${subject.type === 'PullRequest' ? 'pull' : 'issues'}/${number}` };
+  if (note.reason === 'review_requested' && subject.type === 'PullRequest') {
+    const pr = await api(`/repos/${repo}/pulls/${number}`);
+    if (pr.state !== 'open') {
+      return null;
+    }
+    const requested = await api(`/repos/${repo}/pulls/${number}/requested_reviewers`);
+    if (!(requested.users || []).some((user) => user.login === me)) {
+      return null;
+    }
+    return { ...base, id: `gha:${note.id}`, kind: 'review requested', who: pr.user.login, at: note.updated_at, text: oneline(title), body: (pr.body || '').slice(0, 6000) };
+  }
+  let comment = subject.latest_comment_url ? await api(subject.latest_comment_url) : null;
+  const comments = await api(`/repos/${repo}/issues/${number}/comments?per_page=100`);
+  if (!comment || !(comment.body || '').includes(`@${me}`)) {
+    const hits = comments.filter((candidate) => (candidate.body || '').includes(`@${me}`));
+    comment = hits.length ? hits[hits.length - 1] : comment;
+  }
+  if (!comment) {
+    return null;
+  }
+  const at = comment.created_at || note.updated_at;
+  if (comments.some((candidate) => candidate.user.login === me && candidate.created_at > at)) {
+    return null;
+  }
+  return { ...base, id: `gha:${note.id}`, kind: 'mentioned you', who: comment.user.login, at, url: comment.html_url || base.url, text: oneline(comment.body || ''), body: (comment.body || '').replace(/\r/g, '').slice(0, 6000) };
+};
+
+const pollAsks = async (api, context) => {
+  const { org, cache } = context;
+  const notes = await api('/notifications?participating=true&all=false&per_page=50');
+  cache.asks = cache.asks || new Map();
+  const rows = [];
+  const seen = new Set();
+  const relevant = notes.filter((note) => note.repository.full_name.startsWith(`${org}/`) && ['review_requested', 'mention', 'team_mention', 'assign'].includes(note.reason));
+  await mapLimit(relevant, 4, async (note) => {
+    seen.add(note.id);
+    const cached = cache.asks.get(note.id);
+    const row = cached && cached.updated_at === note.updated_at ? cached.row : await buildAsk(api, context, note, note.repository.full_name);
+    cache.asks.set(note.id, { updated_at: note.updated_at, row });
+    if (row) {
+      rows.push(row);
+    }
+  });
+  for (const noteId of [...cache.asks.keys()]) {
+    if (!seen.has(noteId)) {
+      cache.asks.delete(noteId);
+    }
+  }
+  return rows;
+};
+
+export const poll = async ({ settings, http, cache, sinceIso, keyOf }) => {
+  const api = createApi(http, await ghToken(settings.account, cache));
+  const me = settings.me || (cache.me ??= (await api('/user')).login);
+  const context = { repo: settings.repo, org: settings.org || settings.repo.split('/')[0], me, bots: wordsRegex(settings.bots || ['github-actions', 'dependabot', '[bot]']), keyOf, sinceIso, cache };
+  const watchRuns = settings.workflow_runs !== false;
+  const [prsOutcome, asksOutcome, runsOutcome] = await Promise.allSettled([pollPrs(api, context), pollAsks(api, context), watchRuns ? pollRuns(api, context) : { runs: [], activity: [] }]);
+  const errors = {};
+  for (const [part, outcome] of /** @type {[string, PromiseSettledResult<unknown>][]} */ ([['pulls', prsOutcome], ['notifications', asksOutcome], ['runs', runsOutcome]])) {
+    if (outcome.status === 'rejected') {
+      if (outcome.reason instanceof RateLimited) {
+        throw outcome.reason;
+      }
+      errors[part] = `${outcome.reason.name}: ${outcome.reason.message}`;
+    }
+  }
+  const last = cache.last || { prs: [], prActivity: [], asks: [], runs: [], runActivity: [] };
+  cache.last = {
+    prs: prsOutcome.status === 'fulfilled' ? prsOutcome.value.prs : last.prs,
+    prActivity: prsOutcome.status === 'fulfilled' ? prsOutcome.value.activity : last.prActivity,
+    asks: asksOutcome.status === 'fulfilled' ? asksOutcome.value : last.asks,
+    runs: runsOutcome.status === 'fulfilled' ? runsOutcome.value.runs : last.runs,
+    runActivity: runsOutcome.status === 'fulfilled' ? runsOutcome.value.activity : last.runActivity,
+  };
+  const { prs, prActivity, asks, runs, runActivity } = cache.last;
+  return { me, prs, asks, runs, activity: [...prActivity, ...runActivity].sort((a, b) => b.at.localeCompare(a.at)), errors };
+};

package/connectors/index.mjs

@@ -0,0 +1,38 @@
+/** The connector registry: every source type the server knows, and the catalogue the settings form and Claude read. */
+import * as github from './github.mjs';
+import * as jira from './jira.mjs';
+import * as demo from './demo.mjs';
+import * as linear from './linear.mjs';
+
+export const CONNECTORS = { github, jira, linear, demo };
+
+/** What a workspace calls each of its connectors: the entry's own label, else its id when another entry has the same type, else the type's label (RMA-167). */
+export const connectorSummaries = (entries) => entries.map((entry) => {
+  const shared = entries.some((other) => other !== entry && other.type === entry.type);
+  return { id: entry.id, type: entry.type, label: entry.label || (shared ? entry.id : CONNECTORS[entry.type]?.label || entry.type) };
+});
+
+export const connectorCatalogue = () => Object.values(CONNECTORS).map((connector) => ({ type: connector.id, label: connector.label, fields: connector.fields }));
+
+/** The triples a stored secret is bound to: every secret field's service and account plus the connector's endpoint. */
+const secretBindings = (entry) => (CONNECTORS[entry.type]?.fields || []).filter((field) => field.secret).map((field) => {
+  const target = secretTarget(entry, field.key);
+  return target ? { key: field.key, service: target.service, account: target.account, endpoint: String(entry[CONNECTORS[entry.type].endpointKey] || '') } : null;
+}).filter(Boolean);
+
+/** Secret fields of `entry` that must come with a fresh token because their service, account and endpoint triple is not already in the current config. */
+export const secretsRequired = (currentEntries, entry) => {
+  const known = new Set(currentEntries.flatMap(secretBindings).map((binding) => `${binding.service}\n${binding.account}\n${binding.endpoint}`));
+  return secretBindings(entry).filter((binding) => !known.has(`${binding.service}\n${binding.account}\n${binding.endpoint}`)).map((binding) => binding.key);
+};
+
+/** Resolves where a secret field of one connector entry is stored: the service and the account to file it under. */
+export const secretTarget = (entry, key) => {
+  const field = (CONNECTORS[entry.type]?.fields || []).find((candidate) => candidate.key === key && candidate.secret);
+  if (!field) {
+    return null;
+  }
+  const account = String(entry[field.secret.account] || '').trim();
+  const service = String(entry[field.secret.service] || field.secret.default || '').trim();
+  return account && service ? { service, account } : null;
+};

package/connectors/jira.mjs

@@ -0,0 +1,155 @@
+/** Jira Cloud connector: your tickets by JQL with all comments (ADF turned into text) and the changelog entry for the current status. Token from the secret store. */
+import { toIsoUtc, mapLimit } from '../lib/text.mjs';
+import { cachedToken } from '../lib/token-cache.mjs';
+
+const DEFAULT_SERVICE = 'whose-turn-jira';
+
+export const id = 'jira';
+export const label = 'Jira';
+export const links = (settings) => (settings.base ? [{ label: 'Jira', url: String(settings.base).replace(/\/$/, '') }] : []);
+export const endpointKey = 'base';
+export const fields = [
+  { key: 'base', label: 'Site', hint: 'https://your-site.atlassian.net', required: true },
+  { key: 'email', label: 'Account email', hint: 'the account the API token belongs to', required: true },
+  { key: 'token', label: 'API token', hint: 'stored in the secret store, never in the config', secret: { account: 'email', service: 'token_service', default: DEFAULT_SERVICE } },
+  { key: 'token_service', label: 'Secret entry', hint: 'name of the secret-store entry; default whose-turn-jira' },
+  { key: 'jql', label: 'JQL', hint: 'which tickets to watch; leave empty for the default' },
+];
+
+const SIMPLE_MARKS = { code: '`', strong: '**' };
+
+export const adfToText = (node, meId, meName) => {
+  if (!node) {
+    return '';
+  }
+  const type = node.type;
+  const children = node.content || [];
+  const inner = (separator = '') => children.map((child) => adfToText(child, meId, meName)).join(separator);
+  if (type === 'text') {
+    let text = node.text || '';
+    for (const mark of node.marks || []) {
+      if (SIMPLE_MARKS[mark.type]) {
+        text = `${SIMPLE_MARKS[mark.type]}${text}${SIMPLE_MARKS[mark.type]}`;
+      } else if (mark.type === 'link') {
+        const href = (mark.attrs || {}).href || '';
+        text = href && href !== text ? `[${text}](${href})` : text;
+      }
+    }
+    return text;
+  }
+  if (type === 'mention') {
+    const attrs = node.attrs || {};
+    return attrs.id === meId ? `@${meName}` : attrs.text || '@someone';
+  }
+  if (type === 'hardBreak') {
+    return '\n';
+  }
+  if (type === 'paragraph') {
+    return `${inner()}\n\n`;
+  }
+  if (type === 'heading') {
+    return `${'#'.repeat(Number((node.attrs || {}).level || 2))} ${inner()}\n\n`;
+  }
+  if (type === 'codeBlock') {
+    return `\`\`\`\n${inner()}\n\`\`\`\n\n`;
+  }
+  if (type === 'blockquote') {
+    return `${inner().trim().split('\n').map((line) => `> ${line}`).join('\n')}\n\n`;
+  }
+  if (type === 'bulletList' || type === 'orderedList') {
+    return `${children.map((item, index) => `${type === 'orderedList' ? `${index + 1}.` : '-'} ${adfToText(item, meId, meName).trim().replace(/\n\n/g, '\n')}`).join('\n')}\n\n`;
+  }
+  if (['mediaSingle', 'mediaGroup', 'media', 'mediaInline'].includes(type)) {
+    return '[image]';
+  }
+  if (type === 'inlineCard' || type === 'blockCard') {
+    return (node.attrs || {}).url || '';
+  }
+  if (type === 'emoji') {
+    return (node.attrs || {}).text || '';
+  }
+  return inner();
+};
+
+const createApi = (http, base, email, token) => {
+  const auth = Buffer.from(`${email}:${token}`).toString('base64');
+  return (path, body) => http.fetchJson(`${base}${path}`, { method: body === undefined ? 'GET' : 'POST', body, useEtag: false, headers: { Authorization: `Basic ${auth}`, Accept: 'application/json' } });
+};
+
+const statusEntered = async (api, cache, key, updated, status) => {
+  const cached = cache.get(key);
+  if (cached && cached.updated === updated) {
+    return cached.info;
+  }
+  let info = null;
+  let start = 0;
+  for (;;) {
+    const page = await api(`/rest/api/3/issue/${key}/changelog?startAt=${start}&maxResults=100`);
+    for (const history of page.values || []) {
+      for (const item of history.items || []) {
+        if (item.field === 'status' && String(item.toString || '').toLowerCase() === status.toLowerCase()) {
+          const at = toIsoUtc(history.created);
+          if (!info || at > info.since) {
+            info = { since: at, by: (history.author || {}).displayName || '' };
+          }
+        }
+      }
+    }
+    if (page.isLast !== false || !(page.values || []).length) {
+      break;
+    }
+    start += page.values.length;
+  }
+  cache.set(key, { updated, info });
+  return info;
+};
+
+const jiraToken = async (settings, secrets, cache) => {
+  const service = settings.token_service || DEFAULT_SERVICE;
+  const token = await cachedToken(cache, () => secrets.get(service, settings.email));
+  if (!token) {
+    throw new Error(`No Jira API token in the secret store (service ${service}, account ${settings.email})`);
+  }
+  return token;
+};
+
+export const poll = async ({ settings, http, secrets, cache }) => {
+  const base = String(settings.base).replace(/\/$/, '');
+  if (!base.startsWith('https://')) {
+    throw new Error('jira.base must start with https://');
+  }
+  const api = createApi(http, base, settings.email, await jiraToken(settings, secrets, cache));
+  cache.me ??= await api('/rest/api/3/myself');
+  const meId = cache.me.accountId;
+  const meName = cache.me.displayName || 'me';
+  const jql = settings.jql || '(assignee = currentUser() AND statusCategory != Done) OR (assignee was currentUser() AND updated >= -30d) ORDER BY updated DESC';
+  const result = await api('/rest/api/3/search/jql', { jql, maxResults: 100, fields: ['summary', 'status', 'assignee', 'updated', 'comment'] });
+  const tickets = [];
+  const comments = [];
+  for (const issue of result.issues || []) {
+    const fields = issue.fields;
+    const url = `${base}/browse/${issue.key}`;
+    tickets.push({
+      key: issue.key, summary: fields.summary || '', status: (fields.status || {}).name || '', status_category: ((fields.status || {}).statusCategory || {}).key || '',
+      assignee: (fields.assignee || {}).displayName || 'Unassigned', updated: fields.updated || '', url,
+    });
+    for (const comment of ((fields.comment || {}).comments || [])) {
+      const body = comment.body;
+      comments.push({
+        id: comment.id, key: issue.key, at: toIsoUtc(comment.created), author: (comment.author || {}).displayName || '',
+        body: body && typeof body === 'object' ? adfToText(body, meId, meName).trim() : String(body || ''), url: `${url}?focusedCommentId=${comment.id}`,
+      });
+    }
+  }
+  cache.statusEntered ??= new Map();
+  const errors = {};
+  await mapLimit(tickets.filter((ticket) => ticket.status_category !== 'done'), 4, async (ticket) => {
+    try {
+      ticket.status_change = await statusEntered(api, cache.statusEntered, ticket.key, ticket.updated, ticket.status);
+    } catch (error) {
+      ticket.status_change = null;
+      errors.changelog = `${error.name}: ${error.message}`;
+    }
+  });
+  return { me: meName, tickets, comments, ticket_base: `${base}/browse/`, errors };
+};

package/connectors/linear.mjs

@@ -0,0 +1,113 @@
+/** Linear connector: your issues in one workspace (optionally one team or project) with comments and the moment they entered their state. API key from the secret store. */
+import { toIsoUtc } from '../lib/text.mjs';
+import { linearQuery } from '../lib/linear-api.mjs';
+import { cachedToken } from '../lib/token-cache.mjs';
+
+const DEFAULT_SERVICE = 'whose-turn-linear';
+
+export const id = 'linear';
+export const label = 'Linear';
+export const links = (settings) => (settings.workspace ? [{ label: 'Linear', url: `https://linear.app/${settings.workspace}${settings.team ? `/team/${settings.team}` : ''}` }] : []);
+export const fields = [
+  { key: 'workspace', label: 'Workspace slug', hint: 'the part after linear.app/ in your issue links', required: true },
+  { key: 'api_key', label: 'API key', hint: 'a personal API key, stored in the secret store, never in the config', secret: { account: 'workspace', service: 'token_service', default: DEFAULT_SERVICE } },
+  { key: 'token_service', label: 'Secret entry', hint: 'name of the secret-store entry; default whose-turn-linear' },
+  { key: 'team', label: 'Team key', hint: 'only issues of this team, for example TEAM; empty for all' },
+  { key: 'project', label: 'Project', hint: 'only issues of this project, by name; empty for all' },
+];
+
+const QUERY = `
+query Mine($filter: IssueFilter!, $after: String) {
+  viewer { id name displayName }
+  issues(filter: $filter, first: 50, after: $after, orderBy: updatedAt) {
+    pageInfo { hasNextPage endCursor }
+    nodes {
+      id identifier title url updatedAt completedAt
+      state { name type }
+      assignee { id name displayName }
+      comments(first: 50) { nodes { id body createdAt url user { id name displayName } } }
+      history(first: 25) { nodes { createdAt toState { name } actor { name displayName } } }
+    }
+  }
+}`;
+
+const CATEGORY = { completed: 'done', canceled: 'done', started: 'indeterminate', backlog: 'new', unstarted: 'new', triage: 'new' };
+
+const mentionText = (body) => String(body || '').replace(/\[@?([^\]]+)\]\(https:\/\/linear\.app\/[^)]*\/profiles\/[^)]*\)/g, '@$1');
+
+const stateEntered = (issue) => {
+  const entries = (issue.history?.nodes || []).filter((entry) => entry.toState && entry.toState.name === issue.state?.name);
+  if (!entries.length) {
+    return null;
+  }
+  const latest = entries.sort((a, b) => String(b.createdAt).localeCompare(String(a.createdAt)))[0];
+  return { since: toIsoUtc(latest.createdAt), by: latest.actor?.displayName || latest.actor?.name || '' };
+};
+
+const buildFilter = (settings, done) => {
+  const filter = { assignee: { isMe: { eq: true } } };
+  if (done) {
+    filter.completedAt = { gte: new Date(Date.now() - 30 * 86400000).toISOString() };
+  } else {
+    filter.state = { type: { nin: ['completed', 'canceled'] } };
+  }
+  if (settings.team) {
+    filter.team = { key: { eq: settings.team } };
+  }
+  if (settings.project) {
+    filter.project = { name: { eqIgnoreCase: settings.project } };
+  }
+  return filter;
+};
+
+const apiKey = async (settings, secrets, cache) => {
+  const service = settings.token_service || DEFAULT_SERVICE;
+  const token = await cachedToken(cache, () => secrets.get(service, settings.workspace));
+  if (!token) {
+    throw new Error(`No Linear API key in the secret store (service ${service}, account ${settings.workspace})`);
+  }
+  return token;
+};
+
+const fetchAll = async (http, key, filter) => {
+  const nodes = [];
+  let after = null;
+  let viewer = null;
+  for (let page = 0; page < 10; page += 1) {
+    const data = await linearQuery(http, key, QUERY, { filter, after });
+    viewer = data.viewer;
+    nodes.push(...data.issues.nodes);
+    if (!data.issues.pageInfo.hasNextPage) {
+      break;
+    }
+    after = data.issues.pageInfo.endCursor;
+  }
+  return { viewer, nodes };
+};
+
+export const normalise = (issues, viewer) => {
+  const me = viewer.displayName || viewer.name || '';
+  const tickets = [];
+  const comments = [];
+  for (const issue of issues) {
+    tickets.push({
+      key: issue.identifier, summary: issue.title, status: issue.state?.name || '', status_category: CATEGORY[issue.state?.type] || 'indeterminate',
+      assignee: issue.assignee?.displayName || issue.assignee?.name || 'Unassigned', updated: issue.updatedAt, url: issue.url,
+      status_change: issue.state?.type === 'completed' ? null : stateEntered(issue),
+    });
+    for (const comment of issue.comments?.nodes || []) {
+      comments.push({ id: comment.id, key: issue.identifier, at: toIsoUtc(comment.createdAt), author: comment.user?.displayName || comment.user?.name || '', body: mentionText(comment.body), url: comment.url || issue.url });
+    }
+  }
+  const base = tickets[0] ? tickets[0].url.replace(/\/issue\/[^/]+.*$/, '/issue/') : '';
+  return { me, tickets, comments, ticket_base: base };
+};
+
+export const poll = async ({ settings, http, secrets, cache }) => {
+  const key = await apiKey(settings, secrets, cache);
+  const [open, done] = await Promise.all([fetchAll(http, key, buildFilter(settings, false)), fetchAll(http, key, buildFilter(settings, true))]);
+  const seen = new Set();
+  const issues = [...open.nodes, ...done.nodes].filter((issue) => !seen.has(issue.id) && seen.add(issue.id));
+  const result = normalise(issues, open.viewer || done.viewer || {});
+  return { ...result, ticket_base: result.ticket_base || `https://linear.app/${settings.workspace}/issue/`, errors: {} };
+};

package/dist/assets/_plugin-vue_export-helper-BKveAJb2.css

@@ -0,0 +1 @@
+:root{--page-bg: #f3f4f8;--tip-bg: #1f2433;--tip-ink: #e8ecf5;--tip-edge: rgb(255 255 255 / 12%);--tip-shadow: rgb(0 0 0 / 45%)}@media(prefers-color-scheme:dark){:root{--page-bg: #0d0f13}}@media(prefers-color-scheme:light){:root{--tip-bg: #fff;--tip-ink: #1d2023;--tip-edge: #d3d6de;--tip-shadow: rgb(0 0 0 / 18%)}}.app{--md-primary: #2c5697;--md-on-primary: #fff;--md-primary-container: #d8e2ff;--md-on-primary-container: #001a41;--md-secondary-container: #dae2f9;--md-on-secondary-container: #131c2b;--md-tertiary-container: #c8f0ec;--md-on-tertiary-container: #00201e;--md-warn-container: #ffdea6;--md-on-warn-container: #271900;--md-error: #ba1a1a;--md-error-container: #ffdad6;--md-on-error-container: #410002;--md-surface: #f9f9ff;--md-s-low: #fff;--md-s: #f1f3f9;--md-s-high: #e7e9f0;--md-s-highest: #e0e2ea;--md-on-surface: #191c20;--md-on-surface-variant: #44474e;--md-outline: #74777f;--md-outline-variant: #d3d6de;--md-state: 25, 28, 32;--state-hover: rgb(var(--md-state), .08);--focus-ring: 2px solid var(--md-primary);--glass: 255, 255, 255;--glass-a: .52;--glass-edge: rgb(255 255 255 / 70%);--glass-hi: rgb(255 255 255 / 90%);--blob-1: rgb(44 86 151 / 30%);--blob-2: rgb(0 169 224 / 22%);--blob-3: rgb(23 223 220 / 16%);--md-font: roboto, inter, -apple-system, blinkmacsystemfont, "Segoe UI", system-ui, sans-serif;--md-r-card: 12px;--md-r-chip: 8px;--new: #5cc8f0;--new-bg: rgb(92 200 240 / 17%);--new-ink: #04222e;--new-edge: rgb(92 200 240 / 28%);--new-glow: rgb(92 200 240 / 45%);--move: #e0a030;--live-on: #2bb673;--live-off: #d6455d;--live-warn: #e0a030;--live-pulse-from: rgb(43 182 115 / 50%);--live-pulse-to: rgb(43 182 115 / 0%);--live-pulse-rest: rgb(43 182 115 / 60%)}@media(prefers-color-scheme:dark){.app{--md-primary: #adc6ff;--md-on-primary: #0f2f60;--md-primary-container: #2b4678;--md-on-primary-container: #d8e2ff;--md-secondary-container: #3e4759;--md-on-secondary-container: #dae2f9;--md-tertiary-container: #1f504c;--md-on-tertiary-container: #b4efe9;--md-warn-container: #5c4300;--md-on-warn-container: #ffdea6;--md-error: #ffb4ab;--md-error-container: #93000a;--md-on-error-container: #ffdad6;--md-surface: #111318;--md-s-low: #1b1e23;--md-s: #1f2227;--md-s-high: #292c32;--md-s-highest: #34373d;--md-on-surface: #e2e2e9;--md-on-surface-variant: #c4c6d0;--md-outline: #8e9099;--md-outline-variant: #3a3d44;--md-state: 226, 226, 233;--glass: 30, 34, 42;--glass-a: .55;--glass-edge: rgb(255 255 255 / 9%);--glass-hi: rgb(255 255 255 / 6%);--blob-1: rgb(44 86 151 / 55%);--blob-2: rgb(0 169 224 / 28%);--blob-3: rgb(23 223 220 / 14%)}}:root,.page,.page__mount,.app{height:100%;margin:0}:where(.page) button{box-sizing:content-box;margin:0;padding:0;border:0;background:none;color:inherit;font:inherit;letter-spacing:inherit;word-spacing:inherit;text-align:inherit;text-transform:inherit;text-indent:inherit;text-shadow:inherit;-webkit-appearance:none;-moz-appearance:none;appearance:none}.page{background:var(--page-bg);overflow:hidden}.page--scroll{overflow:auto}.dashboard{position:relative;isolation:isolate;box-sizing:border-box;display:grid;gap:12px;padding:14px;border-radius:20px;font-family:var(--md-font);color:var(--md-on-surface);font-size:14px;line-height:1.43;letter-spacing:.01em}.dashboard:before{content:"";position:absolute;top:0;right:0;bottom:0;left:0;z-index:-1;border-radius:20px;pointer-events:none;background:radial-gradient(60% 55% at 12% 8%,var(--blob-1),transparent 70%),radial-gradient(45% 50% at 92% 30%,var(--blob-2),transparent 70%),radial-gradient(55% 60% at 55% 105%,var(--blob-3),transparent 70%)}.dashboard__backdrop{position:absolute;top:0;right:0;bottom:0;left:0;z-index:-1;width:100%;height:100%;border-radius:20px;pointer-events:none}.dashboard a{color:var(--md-primary);text-decoration:none}.dashboard a:hover{text-decoration:underline;text-underline-offset:3px}.dashboard a:focus-visible{outline:var(--focus-ring);outline-offset:2px;border-radius:4px}.dashboard a.btn{text-decoration:none}.dashboard__layout{display:grid;gap:12px;grid-template-columns:minmax(0,2.2fr) minmax(0,1fr);align-items:start}.dashboard__main{display:grid;gap:12px;min-width:0}.dashboard__feed{position:sticky;top:12px;max-height:calc(100vh - 24px);display:flex;flex-direction:column}@media(min-width:901px){.dashboard.dashboard--fit{height:var(--dashboard-height, calc(100vh - 120px) );grid-template-rows:auto minmax(0,1fr);overflow:hidden}.dashboard--fit .dashboard__layout{min-height:0;height:100%;align-items:stretch}.dashboard--fit .dashboard__main{display:flex;flex-direction:column;gap:12px;min-height:0}.dashboard--fit .dashboard__main>.island{display:flex;flex-direction:column;min-height:0}.dashboard--fit .dashboard__move{flex:0 1 auto;max-height:60%}.dashboard--fit .dashboard__todo{flex:0 0 auto;max-height:30%}.dashboard--fit .dashboard__waiting{flex:1 1 0}.dashboard--fit .dashboard__waiting:not(.island--collapsed){min-height:5rem}.dashboard--fit .dashboard__feed{position:static;max-height:none;height:100%;min-height:0}}.dashboard--fit .dashboard__main:has(.dashboard__waiting.island--collapsed) .dashboard__move:not(.island--collapsed){max-height:none;flex:1 1 0}.dashboard--fit .dashboard__main:has(.dashboard__waiting.island--collapsed):has(.dashboard__move.island--collapsed) .dashboard__todo:not(.island--collapsed){max-height:none;flex:1 1 0}.dashboard--fit .dashboard__main>.island--collapsed{flex:0 0 auto;max-height:none}.dashboard--fit .dashboard__feed.island--collapsed{height:auto;align-self:start}@media(max-width:900px){.page{overflow:auto}.dashboard__layout{grid-template-columns:1fr}.dashboard__feed{position:static;max-height:none}}.island{min-width:0;overflow:hidden;border:1px solid var(--glass-edge);border-radius:var(--md-r-card);background:rgb(var(--glass),var(--glass-a));-webkit-backdrop-filter:blur(8px) saturate(150%);backdrop-filter:blur(8px) saturate(150%);box-shadow:inset 0 1px 0 var(--glass-hi),0 8px 24px #0000002e}.fold-toggle{flex:none;display:inline-grid;place-items:center;width:24px;height:24px;margin-left:6px;border-radius:50%;cursor:pointer;color:var(--md-on-surface-variant);font-size:18px;line-height:1;transition:transform .15s ease}.fold-toggle:hover{background:var(--state-hover)}.fold-toggle--folded{transform:rotate(-90deg)}.table{width:100%;border-collapse:collapse;font-size:14px}.table th{text-align:left;font-weight:500;color:var(--md-on-surface-variant);background:rgb(var(--glass),.32);-webkit-backdrop-filter:blur(10px) saturate(140%);backdrop-filter:blur(10px) saturate(140%);font-size:12px;line-height:16px;letter-spacing:.03em;padding:8px 12px;border-bottom:1px solid var(--glass-edge);white-space:nowrap}.table td{padding:12px;border-bottom:1px solid var(--md-outline-variant);vertical-align:top}.table th:first-child,.table td:first-child{padding-left:20px}.table th:last-child,.table td:last-child{padding-right:20px}.table tbody tr:last-child td{border-bottom:0}.table tbody tr:hover td{background:var(--state-hover)}.table__actions-col{width:1%}.table__actions{white-space:nowrap}.table__actions>*{vertical-align:middle}.table__ai{margin-right:6px}@media(min-width:901px){.dashboard--fit .table thead th{position:sticky;top:0;z-index:1}}@media(prefers-reduced-transparency:reduce){.island,.table th{background:var(--md-s-low);-webkit-backdrop-filter:none;backdrop-filter:none}}.pill{display:inline-block;max-width:100%;height:24px;padding:0 10px;overflow:hidden;line-height:24px;text-overflow:ellipsis;border-radius:var(--md-r-chip);font-size:12px;font-weight:500;letter-spacing:.03em;white-space:nowrap;background:var(--md-s-high);color:var(--md-on-surface-variant)}.pill--bad{background:var(--md-error-container);color:var(--md-on-error-container)}.pill--warn{background:var(--md-warn-container);color:var(--md-on-warn-container)}.pill--ok{background:var(--md-tertiary-container);color:var(--md-on-tertiary-container)}.pill--info{background:var(--md-secondary-container);color:var(--md-on-secondary-container)}.age{display:inline-flex;align-items:center;height:18px;padding:0 6px;border-radius:6px;font-size:11px;font-weight:600;font-variant-numeric:tabular-nums;color:var(--md-on-surface-variant);background:var(--md-s-high);cursor:help;white-space:nowrap}.age--old{color:var(--md-on-warn-container);background:var(--md-warn-container)}.handled-chip{display:inline-flex;align-items:center;height:18px;padding:0 7px;margin-left:6px;border-radius:999px;font-size:10px;font-weight:700;letter-spacing:.04em;background:var(--md-s-highest);color:var(--md-on-surface-variant);vertical-align:middle}.at-you{display:inline-block;padding:1px 7px;border-radius:4px;font-size:11px;font-weight:800;letter-spacing:.03em;background:var(--md-warn-container);color:var(--md-on-warn-container)}.ticket-key{white-space:nowrap;font-variant-numeric:tabular-nums;font-weight:500}.timestamp{color:var(--md-on-surface-variant);white-space:nowrap;font-size:12px;font-variant-numeric:tabular-nums}.ai-hint{font-size:12px;opacity:.8}.hint-icon{display:inline-flex;align-items:center;justify-content:center;flex:none;box-sizing:border-box;width:16px;height:16px;padding:0;border:1px solid var(--md-outline);border-radius:50%;font-size:10px;font-weight:700;line-height:1;text-align:center;color:var(--md-on-surface-variant);cursor:pointer;-webkit-user-select:none;user-select:none}.hint-icon:hover,.hint-icon[aria-expanded=true]{color:var(--md-primary);border-color:var(--md-primary)}.hint-icon:focus-visible{outline:var(--focus-ring);outline-offset:2px}.hint-row{display:flex;align-items:center;gap:6px;min-width:0}.empty{color:var(--md-on-surface-variant);font-size:14px;margin:12px 0 0;padding-bottom:14px}.visually-hidden{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)}@media(max-width:640px){.hide-narrow{display:none}}.btn{display:inline-flex;align-items:center;height:32px;padding:0 14px;border:1px solid var(--md-outline);border-radius:999px;font-size:13px;font-weight:500;color:var(--md-primary);background:transparent;cursor:pointer;-webkit-user-select:none;user-select:none}.btn--tonal{background:var(--md-secondary-container);color:var(--md-on-secondary-container);border-color:transparent}.btn[aria-disabled=true]{opacity:.38;cursor:default;pointer-events:none}.btn:hover{box-shadow:inset 0 0 0 100px rgb(var(--md-state),.08)}.btn:focus-visible{outline:var(--focus-ring);outline-offset:2px}.btn--danger{color:var(--md-error);border-color:var(--md-error)}.input{font:inherit;font-size:13px;padding:7px 10px;border:1px solid var(--md-outline-variant);border-radius:8px;background:var(--md-s-low);color:var(--md-on-surface)}.input:focus{outline:var(--focus-ring);outline-offset:-1px;border-color:transparent}.alert{margin:0 4px 8px;padding:8px 12px;border-radius:10px;font-size:13px;font-family:var(--md-font);background:var(--md-warn-container);color:var(--md-on-warn-container)}.alert--inline{margin:0 0 8px}.modal{position:fixed;top:0;right:0;bottom:0;left:0;z-index:20;display:grid;place-items:center;padding:24px;background:#00000073;-webkit-backdrop-filter:blur(6px);backdrop-filter:blur(6px)}.modal__card{width:min(760px,100%);max-height:100%;display:flex;flex-direction:column;overflow:hidden;border:1px solid var(--glass-edge);border-radius:16px;background:rgb(var(--glass),.9);-webkit-backdrop-filter:blur(24px) saturate(150%);backdrop-filter:blur(24px) saturate(150%);box-shadow:0 24px 64px #00000073}.modal__head{display:flex;align-items:center;gap:12px;padding:16px 20px;border-bottom:1px solid var(--md-outline-variant)}.modal__title{flex:1;min-width:0;margin:0;font-size:18px;font-weight:500}.modal__meta{color:var(--md-on-surface-variant);font-size:12px}.sheet-form{display:flex;flex-direction:column;gap:14px;padding:16px 20px 24px;overflow:auto;font-size:14px}.sheet-form__heading{margin:10px 0 0;font-size:13px;font-weight:600;text-transform:uppercase;letter-spacing:.04em;color:var(--md-on-surface-variant)}.tippy-box[data-theme~=wt]{border:1px solid var(--tip-edge);border-radius:10px;background:var(--tip-bg);color:var(--tip-ink);box-shadow:0 12px 32px var(--tip-shadow);font:13px/1.5 Roboto,Inter,-apple-system,system-ui,sans-serif}.tippy-box[data-theme~=wt] .tippy-content{padding:10px 12px;white-space:pre-wrap;overflow-wrap:anywhere;max-height:50vh;overflow:auto}.tippy-box[data-theme~=wt]>.tippy-arrow{color:var(--tip-bg)}