@detergent-software/conductor 1.0.0-dev.3 → 1.0.0-dev.31

package/build/watchers/boards-brief.js

@@ -0,0 +1,63 @@
+import { BriefError } from "../brief.js";
+import { areaOfPath } from "./boards-queue.js";
+import { boardsAsk, htmlText, readComments, readViewer, readWorkItems, requireBoard, stateType, tagsOf, workItemId } from "./boards.js";
+const LINKS = new Map([
+    ['System.LinkTypes.Dependency-Forward', 'blocks'],
+    ['System.LinkTypes.Dependency-Reverse', 'blockedBy'],
+    ['System.LinkTypes.Related', 'related'],
+]);
+const LINKED_FIELDS = ['System.Id', 'System.Title', 'System.State'];
+export function boardsBriefs(options = {}) {
+    // The az login's identity by organization: it doesn't change while the daemon runs.
+    const viewers = new Map();
+    return {
+        read: async (item, profile) => {
+            const board = requireBoard(profile);
+            const id = workItemId(item, board);
+            if (id === null)
+                throw new BriefError(`${item} isn't an item of the board keyed ${board.key}`, 'missing');
+            const ask = boardsAsk(options, board, null);
+            const [found] = await readWorkItems(ask, [id], { relations: true });
+            if (!found)
+                throw new BriefError(`Azure DevOps Boards has no work item ${id} (${item})`, 'missing');
+            const links = linksOf(found);
+            const [read, comments, viewer] = await Promise.all([
+                readWorkItems(ask, [...new Set(links.map((l) => l.id))], { fields: LINKED_FIELDS }),
+                readComments(ask, id),
+                viewers.get(board.organization) ?? readViewer(ask),
+            ]);
+            viewers.set(board.organization, viewer);
+            const linked = new Map(read.map((w) => [w.id, w]));
+            const linksAs = (kind) => links.filter((l) => l.kind === kind).map(({ id: to }) => {
+                const w = linked.get(to);
+                return { id: `${board.key}-${to}`, status: w ? text(w.fields['System.State']) : null, title: w ? text(w.fields['System.Title']) : null };
+            });
+            const state = String(found.fields['System.State'] ?? '');
+            return {
+                area: areaOfPath(String(found.fields['System.AreaPath'] ?? ''), board.areaRoot),
+                blockedBy: linksAs('blockedBy'),
+                blocks: linksAs('blocks'),
+                comments,
+                description: htmlText(String(found.fields['System.Description'] ?? '')).trim(),
+                labels: tagsOf(found.fields['System.Tags']),
+                related: linksAs('related'),
+                status: { name: state, type: stateType(state, board) },
+                title: String(found.fields['System.Title'] ?? ''),
+                trackerProject: null,
+                url: `${board.base}/_workitems/edit/${id}`,
+                viewer,
+            };
+        },
+    };
+}
+function linksOf(w) {
+    return (w.relations ?? []).flatMap((r) => {
+        const kind = LINKS.get(r.rel);
+        const id = /\/workItems\/(\d+)$/i.exec(r.url)?.[1];
+        return kind && id ? [{ id: Number(id), kind }] : [];
+    });
+}
+function text(value) {
+    return typeof value === 'string' ? value : null;
+}
+//# sourceMappingURL=boards-brief.js.map

package/build/watchers/boards-brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards-brief.js","sourceRoot":"","sources":["../../src/watchers/boards-brief.ts"],"names":[],"mappings":"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"}

package/build/watchers/boards-queue.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+import { ConductorError } from "../errors.js";
+import { boardsAsk, CLOSED_TYPES, expectOk, OPEN_TYPES, readWorkItems, requireBoard, stateType, tagsOf, workItemId } from "./boards.js";
+// The scheduler's read of an ADO Boards queue (design note, section 12): the saved query the
+// profile names is the conducted queue, in its own order (by default Priority, then Backlog
+// Priority). Its items, the in-flight ones and their open Predecessors are read in batches.
+// "B has Predecessor A" is stored on B as a Dependency-Reverse link to A.
+const PREDECESSOR = 'System.LinkTypes.Dependency-Reverse';
+const savedQuery = z.looseObject({ id: z.string(), isFolder: z.boolean().optional(), name: z.string() });
+const queryRun = z.looseObject({ queryType: z.string(), workItems: z.array(z.looseObject({ id: z.number() })).nullish() });
+// The Area of an Area Path: its path below the root, with `/` between levels (as an Area label
+// group's sub-Areas are written); null at the root. A path outside the root keeps all of it.
+export function areaOfPath(path, root) {
+    const levels = (p) => p.split('\\').filter((l) => l !== '');
+    const mine = levels(path);
+    const top = levels(root);
+    const below = top.every((l, i) => mine[i]?.toLowerCase() === l.toLowerCase()) ? mine.slice(top.length) : mine;
+    return below.length > 0 ? below.join('/') : null;
+}
+export function boardsQueue(options = {}) {
+    // A saved query's id and name, by board and the profile's path or id.
+    const queries = new Map();
+    const findQuery = async (ask, board) => {
+        const key = `${board.base} ${board.query}`;
+        const known = queries.get(key);
+        if (known)
+            return known;
+        const answer = await ask(`wit/queries/${encodeURIComponent(board.query)}`);
+        if (answer.status === 404)
+            throw new ConductorError(`Azure DevOps Boards has no saved query "${board.query}" in ${board.project}`);
+        const query = savedQuery.parse(expectOk(answer, `the saved query "${board.query}"`));
+        if (query.isFolder)
+            throw new ConductorError(`"${board.query}" is a query folder: tracker.query names a saved query`);
+        queries.set(key, query);
+        return query;
+    };
+    return {
+        read: async (profile, inFlight, budget) => {
+            const board = requireBoard(profile);
+            const ask = boardsAsk(options, board, budget);
+            const query = await findQuery(ask, board);
+            const answer = await ask(`wit/wiql/${query.id}`);
+            // A query deleted and saved again has a new id: look it up again next time.
+            if (answer.status === 404)
+                queries.delete(`${board.base} ${board.query}`);
+            const ran = queryRun.parse(expectOk(answer, `the saved query "${query.name}"`));
+            if (ran.queryType !== 'flat') {
+                throw new ConductorError(`the saved query "${query.name}" is a ${ran.queryType} query: the queue is a flat list of work items`);
+            }
+            const queued = (ran.workItems ?? []).map((w) => w.id);
+            const flying = inFlight.flatMap((item) => workItemId(item, board) ?? []);
+            const items = new Map();
+            const load = async (ids) => {
+                const missing = [...new Set(ids)].filter((id) => !items.has(id));
+                for (const w of await readWorkItems(ask, missing, { relations: true }))
+                    items.set(w.id, w);
+            };
+            await load([...queued, ...flying]);
+            // A Predecessor outside the query still blocks an open item, so it is read too.
+            const open = [...items.values()].filter((w) => OPEN_TYPES.has(stateType(String(w.fields['System.State'] ?? ''), board)));
+            await load(open.flatMap(predecessors));
+            return boardsSnapshot(board, query.name, queued, flying, items);
+        },
+    };
+}
+// The snapshot from the query's ids (in its order), the in-flight ids and every item read. Open
+// query items are the queue, in one tracker project named after the query, as are in-flight items
+// a query on state has dropped (so the project isn't read as ready to release while they're
+// worked); an open Predecessor outside both is listed without a project, so it holds its Area and
+// blocks.
+export function boardsSnapshot(board, queryName, queued, flying, items) {
+    const type = (w) => stateType(String(w.fields['System.State'] ?? ''), board);
+    const open = new Set([...items.values()].filter((w) => OPEN_TYPES.has(type(w))).map((w) => w.id));
+    const rank = new Map(queued.map((id, i) => [id, i]));
+    const listed = [...new Set([...queued, ...items.keys()])].filter((id) => open.has(id));
+    const issues = listed.flatMap((id) => {
+        const w = items.get(id);
+        if (!w)
+            return [];
+        const priority = Number(w.fields['Microsoft.VSTS.Common.Priority']);
+        const inQuery = rank.has(id);
+        return [
+            {
+                area: areaOfPath(String(w.fields['System.AreaPath'] ?? ''), board.areaRoot),
+                blockedBy: predecessors(w)
+                    .filter((p) => open.has(p))
+                    .map((p) => keyOf(board, p)),
+                createdAt: typeof w.fields['System.CreatedDate'] === 'string' ? w.fields['System.CreatedDate'] : null,
+                id: keyOf(board, id),
+                // ADO tags ignore case and keep the org's spelling, so the human tag is spelt as the scheduler looks for it.
+                labels: tagsOf(w.fields['System.Tags']).map((t) => (t.toLowerCase() === board.humanLabel.toLowerCase() ? board.humanLabel : t)),
+                priority: Number.isInteger(priority) ? priority : null,
+                ...(inQuery ? { rank: rank.get(id) } : {}),
+                stateType: type(w),
+                title: typeof w.fields['System.Title'] === 'string' ? w.fields['System.Title'] : null,
+                trackerProject: inQuery || flying.includes(id) ? queryName : null,
+            },
+        ];
+    });
+    return {
+        areaLabels: [...new Set(issues.flatMap((i) => i.area ?? []))].sort(),
+        closed: flying.filter((id) => {
+            const w = items.get(id);
+            return w !== undefined && CLOSED_TYPES.has(type(w));
+        }).map((id) => keyOf(board, id)),
+        issues,
+        projects: [{ name: queryName, priority: board.priority, sortOrder: 0 }],
+    };
+}
+function keyOf(board, id) {
+    return `${board.key}-${id}`;
+}
+// The ids of a work item's Predecessors.
+function predecessors(w) {
+    return (w.relations ?? []).flatMap((r) => {
+        const id = r.rel === PREDECESSOR ? /\/workItems\/(\d+)$/i.exec(r.url)?.[1] : undefined;
+        return id ? [Number(id)] : [];
+    });
+}
+//# sourceMappingURL=boards-queue.js.map

package/build/watchers/boards-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards-queue.js","sourceRoot":"","sources":["../../src/watchers/boards-queue.ts"],"names":[],"mappings":"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"}

package/build/watchers/boards-writes.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+import { ConductorError } from "../errors.js";
+import { NotePostError } from "../notes.js";
+import { adoMessage, boardsAsk, expectOk, requireBoard, tagsOf, workItemId } from "./boards.js";
+// The conductor's writes to ADO Boards: phase notes as discussion comments, and a rule's tag edit.
+// Neither takes from the watchers' budget, as Linear's writes don't.
+const created = z.looseObject({ id: z.number() });
+// A note as a markdown discussion comment. A refused request (4xx, or 203, ADO's sign-in page for
+// a token it doesn't take) posted nothing; a lost answer or a 5xx may have posted it.
+export function boardsNotes(options = {}) {
+    return {
+        comment: async (item, body, profile) => {
+            const board = requireBoard(profile);
+            const id = itemId(item, board, (message) => new NotePostError(message, 'no'));
+            const ask = boardsAsk(options, board, null);
+            let answer;
+            try {
+                answer = await ask(`wit/workItems/${id}/comments?format=markdown`, { body: { text: body }, method: 'POST', version: '7.1-preview.4' });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                // No az token: nothing was sent.
+                if (error instanceof ConductorError)
+                    throw new NotePostError(message, 'no', error.details);
+                throw new NotePostError(`Azure DevOps unreachable: ${message}`, 'unknown');
+            }
+            if (answer.status === 203 || (answer.status >= 400 && answer.status < 500)) {
+                throw new NotePostError(`Azure DevOps refused the comment on ${item} (${answer.status}${adoMessage(answer.body)})`, 'no');
+            }
+            const comment = answer.status >= 200 && answer.status < 300 ? created.safeParse(answer.body).data : undefined;
+            if (!comment)
+                throw new NotePostError(`Azure DevOps' answer to the comment on ${item} didn't read (${answer.status})`, 'unknown');
+            return { id: String(comment.id), url: `${board.base}/_workitems/edit/${id}` };
+        },
+    };
+}
+const tagged = z.looseObject({ fields: z.record(z.string(), z.unknown()), rev: z.number() });
+// A tag added to or removed from a work item: a patch of `System.Tags` alone, refused by ADO when
+// the item changed since it was read (`test /rev`), so a concurrent edit isn't overwritten.
+export function boardsLabels(options = {}) {
+    return {
+        label: async (item, label, op, profile) => {
+            const board = requireBoard(profile);
+            const id = itemId(item, board, (message) => new ConductorError(message));
+            const ask = boardsAsk(options, board, null);
+            const read = await readTags(ask, id, item);
+            const has = read.tags.some((t) => t.toLowerCase() === label.toLowerCase());
+            if (has === (op === 'add'))
+                return 'already';
+            const tags = op === 'add' ? [...read.tags, label] : read.tags.filter((t) => t.toLowerCase() !== label.toLowerCase());
+            // `add` on System.Tags merges into the tags there (removing nothing), so a list that replaces
+            // them is a `replace`, which needs the field to exist.
+            const patch = [
+                { op: 'test', path: '/rev', value: read.rev },
+                { op: read.tags.length > 0 ? 'replace' : 'add', path: '/fields/System.Tags', value: tags.join('; ') },
+            ];
+            const answer = await ask(`wit/workitems/${id}`, { body: patch, contentType: 'application/json-patch+json', method: 'PATCH' });
+            const failed = `Azure DevOps didn't ${op} the tag "${label}" on ${item}`;
+            if (answer.status < 200 || answer.status > 299)
+                throw new ConductorError(`${failed} (${answer.status}${adoMessage(answer.body)})`);
+            // A patch ADO takes without changing anything still answers 200, so the answer's tags decide.
+            const after = tagged.safeParse(answer.body).data;
+            const now = tagsOf(after?.fields['System.Tags']).some((t) => t.toLowerCase() === label.toLowerCase());
+            if (!after || now !== (op === 'add'))
+                throw new ConductorError(`${failed}: its tags are "${String(after?.fields['System.Tags'] ?? '')}"`);
+            return op === 'add' ? 'added' : 'removed';
+        },
+    };
+}
+function itemId(item, board, error) {
+    const id = workItemId(item, board);
+    if (id === null)
+        throw error(`${item} isn't an item of the board keyed ${board.key}, such as ${board.key}-1234`);
+    return id;
+}
+async function readTags(ask, id, item) {
+    const answer = await ask(`wit/workitems/${id}?fields=System.Tags`);
+    if (answer.status === 404)
+        throw new ConductorError(`Azure DevOps Boards has no work item ${id} (${item})`);
+    const w = tagged.parse(expectOk(answer, `work item ${id}`));
+    return { rev: w.rev, tags: tagsOf(w.fields['System.Tags']) };
+}
+//# sourceMappingURL=boards-writes.js.map

package/build/watchers/boards-writes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards-writes.js","sourceRoot":"","sources":["../../src/watchers/boards-writes.ts"],"names":[],"mappings":"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"}

package/build/watchers/boards.js

@@ -0,0 +1,271 @@
+import { z } from 'zod';
+import { ConductorError } from "../errors.js";
+import { notePrefixes } from "../profile.js";
+import { adoRequest, azToken } from "./ado-api.js";
+import { approvalAfterPlan, phaseOf } from "./linear.js";
+import { perWait, spend, WaitProblem } from "./source.js";
+// State names to types for the Scrum, Agile, Basic and CMMI processes; a profile adds its own.
+const BUILT_IN_STATES = {
+    active: 'started',
+    approved: 'unstarted',
+    closed: 'completed',
+    committed: 'started',
+    doing: 'started',
+    done: 'completed',
+    'in progress': 'started',
+    new: 'unstarted',
+    proposed: 'unstarted',
+    removed: 'canceled',
+    resolved: 'started',
+    'to do': 'unstarted',
+};
+export const OPEN_TYPES = new Set(['backlog', 'started', 'unstarted']);
+export const CLOSED_TYPES = new Set(['canceled', 'completed']);
+// ADO's own message in an error answer, as ": <message>", or nothing.
+export function adoMessage(body) {
+    const message = z.looseObject({ message: z.string() }).safeParse(body).data?.message;
+    return message ? `: ${message}` : '';
+}
+// The profile's board, or null when its tracker isn't ADO Boards.
+export function boardOf(profile) {
+    if (profile?.tracker.kind !== 'ado-boards')
+        return null;
+    const { tracker } = profile;
+    const organization = (tracker.organization ?? profile.codeHost.organization).replace(/\/+$/, '');
+    const project = tracker.project ?? profile.codeHost.project;
+    return {
+        areaRoot: tracker.areaRoot ?? project,
+        base: `${organization}/${encodeURIComponent(project)}`,
+        humanLabel: tracker.humanLabel,
+        key: tracker.key,
+        organization,
+        priority: tracker.priority,
+        project,
+        query: tracker.query,
+        states: Object.fromEntries(Object.entries(tracker.states).map(([name, type]) => [name.toLowerCase(), type])),
+    };
+}
+export function boardsAsk({ fetch: fetcher = globalThis.fetch, token = azToken() }, board, budget) {
+    return async (path, { organization = false, version = '7.1', ...init } = {}) => {
+        if (budget)
+            spend(budget);
+        const url = `${organization ? board.organization : board.base}/_apis/${path}${path.includes('?') ? '&' : '?'}api-version=${version}`;
+        return adoRequest(fetcher, token, url, { ...init, ...(budget ? { onRetry: () => spend(budget) } : {}) });
+    };
+}
+// A comment's text: markdown as it is, the web UI's HTML as plain lines.
+export function commentText(text, format) {
+    if (!text)
+        return '';
+    return format?.toLowerCase() === 'html' ? htmlText(text) : text;
+}
+// An answer that has to be 2xx, else an Error naming what was asked: a WaitProblem for a 400 or
+// 404, which asking again won't change (a project or item ADO doesn't have).
+export function expectOk(answer, what) {
+    if (answer.status >= 200 && answer.status <= 299)
+        return answer.body;
+    const message = `Azure DevOps answered ${answer.status} for ${what}${adoMessage(answer.body)}`;
+    throw answer.status === 400 || answer.status === 404 ? new WaitProblem(message) : new Error(message);
+}
+// HTML to the text a reader sees: block ends and <br> as new lines, tags dropped, entities decoded.
+export function htmlText(html) {
+    return html
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<\/(?:blockquote|div|h[1-6]|li|p|pre|tr)>/gi, '\n')
+        .replace(/<[^>]*>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#(\d+);/g, (_, code) => String.fromCodePoint(Number(code)))
+        .replace(/&amp;/g, '&');
+}
+// The state's type, by the profile's map, then the built-in one; null for a state neither knows,
+// which is neither open nor closed, so such an item is never launched or retired.
+export function stateType(state, board) {
+    const name = state.toLowerCase();
+    return board.states[name] ?? BUILT_IN_STATES[name] ?? null;
+}
+// `System.Tags` ("human; docs") as a list.
+export function tagsOf(tags) {
+    return typeof tags === 'string'
+        ? tags
+            .split(';')
+            .map((t) => t.trim())
+            .filter((t) => t !== '')
+        : [];
+}
+// The work item id of `CAD-1234` on the board keyed CAD, or null for another key.
+export function workItemId(item, board) {
+    const match = /^([A-Za-z][A-Za-z0-9]*)-(\d+)$/.exec(item);
+    return match?.[1]?.toUpperCase() === board.key && match[2] ? Number(match[2]) : null;
+}
+const BATCH = 200;
+// The work items with these fields (or all of them and their relations, with `relations`), in
+// batches of 200. An id ADO doesn't have is left out.
+export async function readWorkItems(ask, ids, { fields, relations = false }) {
+    const found = [];
+    for (let at = 0; at < ids.length; at += BATCH) {
+        const batch = ids.slice(at, at + BATCH);
+        // ADO takes either fields or an expand, not both.
+        const body = { errorPolicy: 'Omit', ids: batch, ...(relations ? { $expand: 'Relations' } : { fields }) };
+        const answer = expectOk(await ask('wit/workitemsbatch', { body, method: 'POST' }), 'wit/workitemsbatch');
+        found.push(...z.object({ value: z.array(workItem.nullable()) }).parse(answer).value.flatMap((w) => (w ? [w] : [])));
+    }
+    return found;
+}
+export const workItem = z.looseObject({
+    fields: z.record(z.string(), z.unknown()),
+    id: z.number(),
+    relations: z.array(z.looseObject({ rel: z.string(), url: z.string() })).nullish(),
+    rev: z.number(),
+});
+const commentPage = z.looseObject({
+    comments: z.array(z.looseObject({
+        createdBy: z.looseObject({ id: z.string() }).nullish(),
+        createdDate: z.string(),
+        format: z.string().nullish(),
+        id: z.number(),
+        isDeleted: z.boolean().optional(),
+        text: z.string().nullish(),
+    })),
+    continuationToken: z.string().nullish(),
+});
+const connection = z.looseObject({ authenticatedUser: z.looseObject({ id: z.string() }) });
+// A work item's discussion comments, oldest first, without deleted ones.
+export async function readComments(ask, id) {
+    const comments = [];
+    for (let first = true, token = null; first || token; first = false) {
+        const path = `wit/workItems/${id}/comments?$top=200${token ? `&continuationToken=${encodeURIComponent(token)}` : ''}`;
+        const page = commentPage.parse(expectOk(await ask(path, { version: '7.1-preview.4' }), `the comments of work item ${id}`));
+        for (const c of page.comments) {
+            if (!c.isDeleted)
+                comments.push({ authorId: c.createdBy?.id ?? null, body: commentText(c.text, c.format), createdAt: c.createdDate });
+        }
+        token = page.continuationToken ?? null;
+    }
+    return comments;
+}
+// The az login's identity, whose `approve` / `revise:` counts.
+export async function readViewer(ask) {
+    return connection.parse(expectOk(await ask('connectionData', { organization: true, version: '7.1-preview' }), 'connectionData')).authenticatedUser.id;
+}
+const WAIT_FIELDS = ['System.Id', 'System.Rev', 'System.State', 'System.Tags', 'System.CommentCount'];
+// The approval and item waits on Boards items, for the ADO source. Each pass reads every waited
+// item of a board in one batch (state, tags, rev, comment count), and reads an item's comments only
+// when a wait needs them and they changed since the last read. State lives in memory.
+export function boardsWaits(options = {}) {
+    const boards = new Map();
+    return {
+        check: async (waits, budget, outcomes) => {
+            const byBoard = new Map();
+            for (const wait of waits) {
+                const c = wait.condition;
+                if ((c.kind !== 'approval' && c.kind !== 'item') || c.tracker !== 'ado-boards')
+                    continue;
+                const board = boardOf(wait.profile);
+                if (!board) {
+                    outcomes.set(wait.id, { error: "the project's profile has no ADO Boards tracker" });
+                    continue;
+                }
+                // By ADO project and key: two conducted projects can share an ADO project.
+                const at = `${board.base} ${board.key}`;
+                const group = byBoard.get(at) ?? { board, waits: [] };
+                group.waits.push(wait);
+                byBoard.set(at, group);
+            }
+            for (const [base, group] of byBoard) {
+                try {
+                    await checkBoard(base, group, budget, outcomes);
+                }
+                catch (error) {
+                    // A board ADO refuses (a 400 or 404: a project or item it doesn't have) is a problem with
+                    // its waits alone, so the PR and run waits of the same pass go on.
+                    if (!(error instanceof WaitProblem))
+                        throw error;
+                    for (const wait of group.waits)
+                        if (!outcomes.has(wait.id))
+                            outcomes.set(wait.id, { error: error.message });
+                }
+            }
+        },
+    };
+    async function checkBoard(base, group, budget, outcomes) {
+        const { board } = group;
+        const ask = boardsAsk(options, board, budget);
+        const state = boards.get(base) ?? { items: new Map(), viewer: null };
+        boards.set(base, state);
+        const idOf = new Map(group.waits.map((w) => [w.id, workItemId(itemOf(w), board)]));
+        const ids = [...new Set([...idOf.values()].flatMap((id) => (id === null ? [] : [id])))];
+        const read = await readWorkItems(ask, ids, { fields: WAIT_FIELDS });
+        const seen = new Map(read.map((w) => [w.id, w]));
+        // Only the items something waits on are kept, with their comments.
+        for (const id of state.items.keys())
+            if (!ids.includes(id))
+                state.items.delete(id);
+        for (const id of ids) {
+            const w = seen.get(id);
+            if (!w) {
+                state.items.delete(id);
+                continue;
+            }
+            const was = state.items.get(id);
+            const version = `${w.rev}/${String(w.fields['System.CommentCount'] ?? 0)}`;
+            state.items.set(id, {
+                comments: was?.comments ?? null,
+                readAt: was?.readAt ?? null,
+                state: String(w.fields['System.State'] ?? ''),
+                tags: tagsOf(w.fields['System.Tags']),
+                version,
+            });
+        }
+        const readsNotes = (wait) => wait.condition.kind === 'approval' || (wait.condition.kind === 'item' && wait.condition.field === 'note');
+        if (state.viewer === null && group.waits.some((w) => w.condition.kind === 'approval'))
+            state.viewer = await readViewer(ask);
+        for (const wait of group.waits) {
+            const c = wait.condition;
+            if (c.kind !== 'approval' && c.kind !== 'item')
+                continue;
+            await perWait(outcomes, wait.id, async () => {
+                const id = idOf.get(wait.id) ?? null;
+                if (id === null)
+                    throw new WaitProblem(`${c.item} isn't an item of the board keyed ${board.key}`);
+                const item = state.items.get(id);
+                if (!item)
+                    throw new WaitProblem(`Azure DevOps Boards has no work item ${id} (${c.item})`);
+                if (readsNotes(wait) && (item.comments === null || item.readAt !== item.version)) {
+                    item.comments = await readComments(ask, id);
+                    item.readAt = item.version;
+                }
+                const prefixes = notePrefixes(wait.profile);
+                if (c.kind === 'approval') {
+                    const found = approvalAfterPlan(item.comments ?? [], state.viewer, prefixes);
+                    return found ? `approval ${c.item}: ${found.kind}` : null;
+                }
+                const value = c.value.toLowerCase();
+                if (c.field === 'state') {
+                    const type = stateType(item.state, board);
+                    return item.state.toLowerCase() === value || type === value ? `item ${c.item} state ${item.state}` : null;
+                }
+                if (c.field === 'label') {
+                    const tag = item.tags.find((t) => t.toLowerCase() === value);
+                    return tag ? `item ${c.item} labelled ${tag}` : null;
+                }
+                const note = (item.comments ?? []).map((x) => phaseOf(x.body, prefixes)).find((p) => p?.toLowerCase() === value);
+                return note ? `item ${c.item} note ${note}` : null;
+            });
+        }
+    }
+}
+// A ConductorError for a project whose tracker isn't ADO Boards.
+export function requireBoard(profile) {
+    const board = boardOf(profile);
+    if (!board)
+        throw new ConductorError(`project ${profile?.name ?? '?'} has no ADO Boards tracker`);
+    return board;
+}
+function itemOf(wait) {
+    const c = wait.condition;
+    return c.kind === 'approval' || c.kind === 'item' ? c.item : '';
+}
+//# sourceMappingURL=boards.js.map

package/build/watchers/boards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards.js","sourceRoot":"","sources":["../../src/watchers/boards.ts"],"names":[],"mappings":"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"}

package/build/watchers/github.js

@@ -1,5 +1,7 @@
 import { z } from 'zod';
+import { notePrefixes } from "../profile.js";
 import { outputOf, run } from "../run.js";
+import { noteHeading } from "./linear.js";
 import { perPass, perWait, untilSpent, WaitProblem } from "./source.js";
 const pull = z.looseObject({
     head: z.looseObject({ sha: z.string() }),
@@ -56,9 +58,10 @@ export function githubSource({ gh = ghApi() } = {}) {
                             const failed = runs.filter((r) => !PASSING.has(r.conclusion ?? '')).map((r) => r.name);
                             return failed.length > 0 ? `${at} checks failed: ${failed.join(', ')}` : `${at} checks passed`;
                         }
-                        const note = `${wait.profile?.skills.work ?? 'work-issue'} · `;
+                        const notes = notePrefixes(wait.profile);
                         const since = Date.parse(wait.createdAt);
-                        const byPerson = (u, body, when) => u?.type !== 'Bot' && when != null && Date.parse(when) > since && !(body ?? '').replace(/^[#*\s]+/, '').startsWith(note);
+                        const isNote = (body) => noteHeading(body ?? '', notes) !== null;
+                        const byPerson = (u, body, when) => u?.type !== 'Bot' && when != null && Date.parse(when) > since && !isNote(body);
                         // The comment lists come oldest first, so they're asked from the wait on (`since`), which
                         // keeps a new comment on the first page. Reviews can't be asked that way; a PR has few.
                         const after = `per_page=100&since=${encodeURIComponent(wait.createdAt)}`;