@svp-labs/talos 0.0.0 → 0.1.1

package/dist/jobs/flaky.js

@@ -0,0 +1,151 @@
+import { z } from 'zod';
+import { recentArtifacts } from './artifacts.js';
+import { nameable } from './debt-issues.js';
+import { codeSpan, digest, fileIssue, marker, talosIssues, } from './talos-issues.js';
+import { extractFile } from '../github/artifacts.js';
+import { queueGateRuns } from '../github/gate-runs.js';
+import { fileAt } from '../ticket/github.js';
+import { LABEL } from '../ticket/labels.js';
+import { clip } from '../ticket/payload.js';
+/** The gate uploads its compact verdict as this artifact, holding `verdict.json`. */
+const VERDICT_ARTIFACT = 'talos-verdict';
+/** How far back each daily run looks; a run that failed one day is covered the next. */
+const SEEN_WITHIN_DAYS = 2;
+const MAX_ARTIFACTS = 50;
+const MAX_NEW = 5;
+const MAX_VERDICT_BYTES = 1024 * 1024;
+const verdictFlaky = z.object({
+    schema: z.literal('talos.verdict/1'),
+    pr: z.number().int().nullable().optional(),
+    flaky: z
+        .array(z.object({ id: z.string().min(1).max(1000), file: z.string().nullable() }))
+        .max(1000),
+});
+/** The flaky tests one `verdict.json` reports; anything else in it is ignored. */
+export function flakyIn(text, seenAt) {
+    const verdict = verdictFlaky.parse(JSON.parse(text));
+    return verdict.flaky.map((f) => ({ id: f.id, file: f.file, seenAt, pr: verdict.pr ?? null }));
+}
+/** One candidate per test, from its latest sighting; a test without a file can't be named. */
+export function flakyCandidates(sightings) {
+    const latest = new Map();
+    for (const s of sightings) {
+        if (s.file === null || !nameable(s.file))
+            continue;
+        const known = latest.get(s.id);
+        if (known !== undefined && Date.parse(known.seenAt) >= Date.parse(s.seenAt))
+            continue;
+        latest.set(s.id, { ...s, file: s.file, digest: digest(s.id) });
+    }
+    return [...latest.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+/**
+ * Tests with no open issue. A test whose issue was closed after the sighting was fixed since;
+ * one seen flaking after its issue closed gets a new one.
+ */
+export function unfiled(candidates, existing) {
+    const open = new Set(existing.filter((i) => i.state === 'open').map((i) => i.fields.test));
+    const closed = new Map();
+    for (const issue of existing) {
+        const test = issue.fields.test;
+        if (issue.state !== 'closed' || test === undefined || issue.closedAt === undefined)
+            continue;
+        closed.set(test, Math.max(closed.get(test) ?? 0, Date.parse(issue.closedAt)));
+    }
+    return candidates.filter((c) => !open.has(c.digest) && (closed.get(c.digest) ?? 0) < Date.parse(c.seenAt));
+}
+export function flakyIssue(c) {
+    const test = codeSpan(c.id);
+    const where = c.pr === null ? '' : ` (on PR #${c.pr})`;
+    const body = [
+        marker('flaky', { test: c.digest, file: c.file }),
+        '',
+        '### Goal',
+        '',
+        `Make ${test} pass reliably, so the gate no longer has to let it through as flaky.`,
+        '',
+        '### Repro',
+        '',
+        `Run the tests of \`${c.file}\` repeatedly: the gate saw this test fail and then pass on ` +
+            `its immediate rerun, last on ${c.seenAt.slice(0, 10)}${where}.`,
+        '',
+        '### Expected / Actual',
+        '',
+        'Expected: it passes every time. Actual: it sometimes fails, and passes when run again.',
+        '',
+        '### Acceptance criteria',
+        '',
+        '- [ ] The cause is found and fixed, not hidden behind a retry, a longer timeout or a skip',
+        '- [ ] The test still asserts everything it asserted before',
+        '',
+        '### Out of scope',
+        '',
+        'Other tests, and the rerun policy itself.',
+        '',
+        '### Affected areas',
+        '',
+        `- \`${c.file}\``,
+        '- the code under test, where the cause lies',
+        '',
+    ].join('\n');
+    return {
+        title: `Flaky test: ${clip(c.id, 80)}`,
+        body,
+        labels: [LABEL.bug, LABEL.flaky, LABEL.ready, LABEL.eligible, LABEL.p2],
+    };
+}
+/**
+ * The flaky tests the gate saw in the merge queue lately. Only there has review passed the code
+ * whose test names a sighting carries, and only the gate's own runs count: any workflow can
+ * upload an artifact by the gate's name.
+ */
+async function sightings(deps, at) {
+    const since = new Date(at.now.getTime() - SEEN_WITHIN_DAYS * 86_400_000);
+    const gate = new Set((await queueGateRuns(deps.actions, at.repo, { since, talosRepo: at.talosRepo })).map((r) => r.id));
+    if (gate.size === 0)
+        return { found: [], unreadable: 0 };
+    const artifacts = (await recentArtifacts(deps.actions, at.repo, {
+        name: VERDICT_ARTIFACT,
+        since,
+        max: MAX_ARTIFACTS,
+    })).filter((artifact) => artifact.runId !== undefined && gate.has(artifact.runId));
+    const found = [];
+    let unreadable = 0;
+    for (const artifact of artifacts) {
+        try {
+            const text = extractFile(await deps.download(artifact.url), 'verdict.json', MAX_VERDICT_BYTES);
+            if (text !== undefined)
+                found.push(...flakyIn(text, artifact.createdAt));
+        }
+        catch {
+            unreadable += 1;
+        }
+    }
+    return { found, unreadable };
+}
+/**
+ * Files one issue per flaky test the gate reported recently in the merge queue, for tests still
+ * on the default branch, at most five a day.
+ */
+export async function fileFlakyIssues(deps, at) {
+    const { found, unreadable } = await sightings(deps, {
+        repo: at.repo,
+        talosRepo: at.who.talosRepo,
+        now: at.now,
+    });
+    const candidates = flakyCandidates(found);
+    if (candidates.length === 0)
+        return { filed: 0, seen: 0, unreadable };
+    const fresh = unfiled(candidates, await talosIssues(deps.gh, at, LABEL.flaky, 'flaky'));
+    let filed = 0;
+    for (const candidate of fresh) {
+        if (filed >= MAX_NEW)
+            break;
+        if ((await fileAt(deps.gh, at.repo, candidate.file, at.base)) === undefined)
+            continue;
+        await fileIssue(deps.gh, at.repo, flakyIssue(candidate));
+        filed += 1;
+    }
+    return { filed, seen: candidates.length, unreadable };
+}
+//# sourceMappingURL=flaky.js.map

package/dist/jobs/flaky.js.map

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

package/dist/jobs/label-sync.js

@@ -0,0 +1,67 @@
+import { readFile } from 'node:fs/promises';
+import { parse } from 'yaml';
+import { z } from 'zod';
+import { labelListSchema } from '../ticket/schemas.js';
+import { assetsDir } from '../version/self.js';
+const labelsFile = z
+    .array(z.strictObject({
+    name: z.string().min(1).max(50),
+    color: z.string().regex(/^[0-9A-Fa-f]{6}$/, 'six hex digits, no #'),
+    description: z.string().min(1).max(100),
+}))
+    .min(1);
+/** Validates `labels.yml`: names unique without case, colours as hex, descriptions GitHub takes. */
+export function parseLabels(text) {
+    const labels = labelsFile.parse(parse(text));
+    const seen = new Set();
+    for (const label of labels) {
+        const key = label.name.toLowerCase();
+        if (seen.has(key))
+            throw new Error(`labels.yml names ${label.name} twice`);
+        seen.add(key);
+    }
+    return labels;
+}
+/** The labels Talos ships (`assets/labels.yml`). */
+export async function shippedLabels() {
+    return parseLabels(await readFile(new URL('labels.yml', assetsDir()), 'utf8'));
+}
+/**
+ * What label sync changes: missing labels are created, and ones that differ in case, colour or
+ * description updated. Labels the repository has beyond these are its own and stay.
+ */
+export function labelPlan(desired, existing) {
+    const byName = new Map(existing.map((label) => [label.name.toLowerCase(), label]));
+    const create = [];
+    const update = [];
+    for (const label of desired) {
+        const current = byName.get(label.name.toLowerCase());
+        if (current === undefined) {
+            create.push(label);
+            continue;
+        }
+        const same = current.name === label.name &&
+            current.color.toLowerCase() === label.color.toLowerCase() &&
+            (current.description ?? '') === label.description;
+        if (!same)
+            update.push({ ...label, current: current.name });
+    }
+    return { create, update };
+}
+/** Applies {@link labelPlan} to a repository; returns how many labels it created and updated. */
+export async function syncLabels(gh, repo, desired) {
+    const existing = labelListSchema.parse(await gh.paginate(`repos/${repo}/labels`));
+    const plan = labelPlan(desired, existing);
+    for (const label of plan.create) {
+        await gh.request('POST', `repos/${repo}/labels`, {
+            body: { name: label.name, color: label.color, description: label.description },
+        });
+    }
+    for (const label of plan.update) {
+        await gh.request('PATCH', `repos/${repo}/labels/${encodeURIComponent(label.current)}`, {
+            body: { new_name: label.name, color: label.color, description: label.description },
+        });
+    }
+    return { created: plan.create.length, updated: plan.update.length };
+}
+//# sourceMappingURL=label-sync.js.map

package/dist/jobs/label-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-sync.js","sourceRoot":"","sources":["../../src/jobs/label-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQ/C,MAAM,UAAU,GAAG,CAAC;KACjB,KAAK,CACJ,CAAC,CAAC,YAAY,CAAC;IACb,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;IACnE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACxC,CAAC,CACH;KACA,GAAG,CAAC,CAAC,CAAC,CAAC;AAEV,oGAAoG;AACpG,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC;QAC3E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,WAAW,CAAC,MAAM,QAAQ,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AACjF,CAAC;AAcD;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,OAAgC,EAChC,QAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,MAAM,GAA2C,EAAE,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACrD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GACR,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;YAC3B,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;YACzD,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC,WAAW,CAAC;QACpD,IAAI,CAAC,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,EAAU,EACV,IAAY,EACZ,OAAgC;IAEhC,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAU,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC;IAC3F,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,IAAI,SAAS,EAAE;YAC/C,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;SAC/E,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,IAAI,WAAW,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE;YACrF,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;SACnF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;AACtE,CAAC"}

package/dist/jobs/payloads.js

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { sameLogin } from '../github/identities.js';
+import { isTrusted } from '../ticket/trust.js';
+/** The parts of the caller's event payloads the jobs read, validated before use. */
+const actor = z.object({ login: z.string() }).nullable().optional();
+export const issuesEvent = z.object({
+    action: z.string(),
+    issue: z.object({
+        number: z.number().int().positive(),
+        user: actor,
+        author_association: z.string().optional(),
+    }),
+    sender: actor,
+    repository: z.object({ default_branch: z.string().min(1) }).optional(),
+});
+const issueCommentEvent = z.object({
+    comment: z.object({ user: actor, author_association: z.string().optional() }),
+    sender: actor,
+});
+const reviewEvent = z.object({
+    review: z.object({ user: actor, author_association: z.string().optional() }),
+    sender: actor,
+});
+const withRepository = z.object({
+    repository: z.object({ default_branch: z.string().min(1) }),
+});
+/** The default branch an event's payload names, when it names one. */
+export function defaultBranchOf(payload) {
+    const parsed = withRepository.safeParse(payload);
+    return parsed.success ? parsed.data.repository.default_branch : undefined;
+}
+const ADMIT = { admit: true };
+function judgeAuthor(author, who) {
+    if (sameLogin(author.login, who.reviewer)) {
+        return { admit: false, reason: "the reviewer's own event" };
+    }
+    return isTrusted(author, who) ? ADMIT : { admit: false, reason: 'author not trusted' };
+}
+/**
+ * Whether an event may go on to use the reviewer's token or a model at all. On a public
+ * repository a stranger can comment and review, so those two events are admitted only from the
+ * owner, a member, a collaborator or Thea's App (whose `talos-approve` reviews carry the owner's
+ * okay). Decided from the payload alone, before any API call.
+ */
+export function admission(event, payload, who) {
+    if (event === 'issue_comment') {
+        const parsed = issueCommentEvent.safeParse(payload);
+        if (!parsed.success)
+            return { admit: false, reason: 'unreadable payload' };
+        const { comment } = parsed.data;
+        return judgeAuthor({ login: comment.user?.login, association: comment.author_association }, who);
+    }
+    if (event === 'pull_request_review') {
+        const parsed = reviewEvent.safeParse(payload);
+        if (!parsed.success)
+            return { admit: false, reason: 'unreadable payload' };
+        const { review } = parsed.data;
+        return judgeAuthor({ login: review.user?.login, association: review.author_association }, who);
+    }
+    return ADMIT;
+}
+//# sourceMappingURL=payloads.js.map

package/dist/jobs/payloads.js.map

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

package/dist/jobs/readiness-job.js

@@ -0,0 +1,91 @@
+import { issuesEvent } from './payloads.js';
+import { briefLinks, judgeReadiness, needsBrief, readinessComment, readinessLabels, } from './readiness.js';
+import { readMarker } from './talos-issues.js';
+import { sameLogin } from '../github/identities.js';
+import { addComment, changeLabels, defaultBranch, fileAt, getIssue, listComments, } from '../ticket/github.js';
+import { LABEL } from '../ticket/labels.js';
+import { isTalos, isTrusted } from '../ticket/trust.js';
+const JOB = 'readiness';
+/** The issue actions that can change whether an issue is ready. */
+const ACTIONS = new Set([
+    'opened',
+    'edited',
+    'reopened',
+    'labeled',
+    'unlabeled',
+]);
+/** At most this many brief links are looked up: a body can't make the job call the API at will. */
+const MAX_BRIEFS = 5;
+function skipped(detail) {
+    return { job: JOB, result: 'skipped', detail };
+}
+/**
+ * Rewrites the readiness comment in place. A ready issue that never had one gets none: the
+ * comment exists to say what is missing, and to say so no longer once it isn't.
+ */
+async function keepComment(gh, at, text, ready) {
+    const comments = await listComments(gh, at.repo, at.issue);
+    const mine = comments.find((c) => sameLogin(c.author, at.who.reviewer) && readMarker(c.body, 'readiness') !== undefined);
+    if (mine === undefined) {
+        if (!ready)
+            await addComment(gh, at.repo, at.issue, text);
+        return;
+    }
+    if (mine.body.trim() === text.trim())
+        return;
+    await gh.request('PATCH', `repos/${at.repo}/issues/comments/${mine.id}`, {
+        body: { body: text },
+    });
+}
+async function briefsOf(gh, at, links) {
+    const briefs = new Map();
+    for (const path of links.slice(0, MAX_BRIEFS)) {
+        briefs.set(path, (await fileAt(gh, at.repo, path, at.base)) !== undefined);
+    }
+    return briefs;
+}
+/** Why an event is not judged, from the payload alone, before the token is used. */
+export function eventSkip(event, who) {
+    if (!ACTIONS.has(event.action))
+        return `nothing to judge on ${event.action}`;
+    if (sameLogin(event.sender?.login, who.reviewer))
+        return "the reviewer's own change";
+    const author = { login: event.issue.user?.login, association: event.issue.author_association };
+    if (!isTrusted(author, who))
+        return 'author not trusted';
+    return isTalos(author.login, who) ? 'filed by Talos' : undefined;
+}
+async function judge(ctx, gh, at) {
+    const config = await ctx.config(at.base);
+    const { body, labels } = at.issue;
+    const links = needsBrief(labels) ? briefLinks(body, config.docs.briefs) : [];
+    return judgeReadiness({
+        body,
+        labels,
+        briefsDir: config.docs.briefs,
+        briefs: await briefsOf(gh, { repo: ctx.repo, base: at.base }, links),
+    });
+}
+/**
+ * Issue readiness on an `issues` event. Only issues an owner, member or collaborator wrote are
+ * judged; issues marked `legacy` wait until someone rewrites them, and Talos's own are written
+ * ready. Not ready: `needs-spec` and one comment listing what's missing. Ready: `status/ready`.
+ */
+export async function readinessJob(ctx, gh) {
+    const event = issuesEvent.parse(ctx.payload);
+    const skip = eventSkip(event, ctx.who);
+    if (skip !== undefined)
+        return skipped(skip);
+    const issue = await getIssue(gh, ctx.repo, event.issue.number);
+    if (issue === undefined || issue.isPull || issue.state === 'closed')
+        return skipped('not open');
+    if (issue.labels.includes(LABEL.legacy))
+        return skipped('legacy');
+    const base = event.repository?.default_branch ?? (await defaultBranch(gh, ctx.repo));
+    const verdict = await judge(ctx, gh, { issue, base });
+    await changeLabels(gh, ctx.repo, issue.number, readinessLabels(verdict.ready, issue.labels));
+    await keepComment(gh, { repo: ctx.repo, who: ctx.who, issue: issue.number }, readinessComment(verdict.problems), verdict.ready);
+    const detail = verdict.ready ? 'ready' : `not ready: ${verdict.problems.length} problem(s)`;
+    return { job: JOB, result: 'done', detail };
+}
+//# sourceMappingURL=readiness-job.js.map

package/dist/jobs/readiness-job.js.map

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

package/dist/jobs/readiness.js

@@ -0,0 +1,154 @@
+import { marker } from './talos-issues.js';
+import { LABEL, looksClaimed, TYPE_LABELS, typeLabelsOf } from '../ticket/labels.js';
+import { checkboxCount, hasContent, sections } from '../ticket/sections.js';
+/**
+ * Issue readiness: whether an issue is written well enough for anyone, person or agent, to pick
+ * up. Pure; `readiness-job.ts` reads the issue and applies the verdict.
+ */
+const MAX_CRITERIA = 5;
+const HEADINGS = {
+    goal: 'Goal',
+    'acceptance criteria': 'Acceptance criteria',
+    'out of scope': 'Out of scope',
+    'affected areas': 'Affected areas',
+    repro: 'Repro',
+    'expected/actual': 'Expected / Actual',
+};
+const TICKET = ['goal', 'acceptance criteria', 'out of scope', 'affected areas'];
+/**
+ * An epic is split into tickets rather than implemented, so it needs no criteria or areas of
+ * its own; a bug adds how to reproduce it and what should happen instead.
+ */
+export function requiredSections(types) {
+    if (types.length === 1 && types[0] === LABEL.epic)
+        return ['goal', 'out of scope'];
+    return types.includes(LABEL.bug) ? [...TICKET, 'repro', 'expected/actual'] : TICKET;
+}
+/** An epic, and an issue that sets or changes a decision, must link a brief. */
+export function needsBrief(labels) {
+    return labels.includes(LABEL.epic) || labels.includes(LABEL.decision);
+}
+function validDate(month, day) {
+    return month >= 1 && month <= 12 && day >= 1 && day <= 31;
+}
+function trimSlashes(path) {
+    let start = path.startsWith('./') ? 2 : 0;
+    let end = path.length;
+    while (path[start] === '/')
+        start += 1;
+    while (end > start && path[end - 1] === '/')
+        end -= 1;
+    return path.slice(start, end);
+}
+/** What may stand right before a path in Markdown, or a GitHub link's `/blob/<ref>/`. */
+function linkStarts(body, index) {
+    if (index === 0)
+        return true;
+    const before = body.slice(Math.max(0, index - 200), index);
+    return (/[\s([<`"']$/.test(before) || /\/blob\/[^\s/]{1,100}\/$/.test(before) || before.endsWith('./'));
+}
+const BRIEF_NAME = /^\d{4}(\d{2})(\d{2})-[a-z0-9][a-z0-9-]{0,100}\.md(?![\w-]|\.\w)/;
+/**
+ * The briefs a body links: `<briefs>/<YYYYMMDD>-<slug>.md`, written as a path or as a link to
+ * the file on GitHub. `briefsDir` is `talos.yml`'s `docs.briefs`.
+ */
+export function briefLinks(body, briefsDir) {
+    const dir = `${trimSlashes(briefsDir)}/`;
+    const found = [];
+    for (let at = body.indexOf(dir); at !== -1; at = body.indexOf(dir, at + dir.length)) {
+        const start = at + dir.length;
+        const name = BRIEF_NAME.exec(body.slice(start, start + 120));
+        if (name === null || !validDate(Number(name[1]), Number(name[2])))
+            continue;
+        const path = `${dir}${name[0]}`;
+        if (linkStarts(body, at) && !found.includes(path))
+            found.push(path);
+    }
+    return found;
+}
+function typeProblem(types) {
+    if (types.length === 1)
+        return undefined;
+    const has = types.length === 0 ? 'it has none' : `it has ${types.join(', ')}`;
+    return `exactly one type label (${TYPE_LABELS.join(', ')}); ${has}`;
+}
+function sectionProblems(body, required) {
+    const found = sections(body);
+    const problems = [];
+    for (const key of required) {
+        const heading = HEADINGS[key] ?? key;
+        const text = found.get(key);
+        if (text === undefined)
+            problems.push(`a \`## ${heading}\` section`);
+        else if (!hasContent(text))
+            problems.push(`something under \`## ${heading}\``);
+    }
+    const criteria = found.get('acceptance criteria');
+    if (!required.includes('acceptance criteria') || !hasContent(criteria))
+        return problems;
+    const count = checkboxCount(criteria ?? '');
+    if (count === 0)
+        problems.push('at least one `- [ ]` checkbox under Acceptance criteria');
+    if (count > MAX_CRITERIA) {
+        problems.push(`at most ${MAX_CRITERIA} acceptance criteria, not ${count}: split the issue`);
+    }
+    return problems;
+}
+function briefProblems(input) {
+    if (!needsBrief(input.labels))
+        return [];
+    if (input.briefs.size === 0) {
+        return [
+            `a link to its brief, \`${input.briefsDir}/<YYYYMMDD>-<slug>.md\` ` +
+                '(an epic, or an issue labelled `decision`, needs one)',
+        ];
+    }
+    return [...input.briefs]
+        .filter(([, exists]) => !exists)
+        .map(([path]) => `its brief \`${path}\` on the default branch: it isn't there`);
+}
+export function judgeReadiness(input) {
+    const types = typeLabelsOf(input.labels);
+    const problems = [
+        typeProblem(types),
+        ...sectionProblems(input.body, requiredSections(types)),
+        ...briefProblems(input),
+    ].filter((p) => p !== undefined);
+    return { ready: problems.length === 0, problems };
+}
+/**
+ * The label changes a verdict implies. A ready issue becomes `status/ready` unless it is
+ * claimed already or an epic, which is never claimed itself: its tickets are.
+ */
+export function readinessLabels(ready, labels) {
+    const has = (label) => labels.includes(label);
+    if (!ready) {
+        return {
+            add: has(LABEL.needsSpec) ? [] : [LABEL.needsSpec],
+            remove: has(LABEL.ready) ? [LABEL.ready] : [],
+        };
+    }
+    const remove = [LABEL.needsSpec].filter(has);
+    if (has(LABEL.epic))
+        return { add: [], remove: [...remove, ...[LABEL.ready].filter(has)] };
+    const add = has(LABEL.ready) || looksClaimed(labels) ? [] : [LABEL.ready];
+    return { add, remove };
+}
+/** The one comment readiness keeps on an issue, rewritten in place as the issue changes. */
+export function readinessComment(problems) {
+    if (problems.length === 0) {
+        const line = marker('readiness', { ready: 'yes', problems: '0' });
+        return `${line}\n\n**Ready.** This issue passes Talos's readiness check now.\n`;
+    }
+    return [
+        marker('readiness', { ready: 'no', problems: String(problems.length) }),
+        '',
+        "**Not ready yet.** Talos's readiness check needs:",
+        '',
+        ...problems.map((p) => `- ${p}`),
+        '',
+        'Edit the issue: the check runs again on every edit and updates this comment.',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=readiness.js.map

package/dist/jobs/readiness.js.map

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

package/dist/jobs/schedule.js

@@ -0,0 +1,19 @@
+const MONDAY = 1;
+export function isDue(cadence, event, now) {
+    if (event === 'workflow_dispatch')
+        return true;
+    if (event !== 'schedule')
+        return false;
+    return cadence === 'daily' || now.getUTCDay() === MONDAY;
+}
+/**
+ * Whether a scheduled or dispatched run is on the default branch. A manual dispatch can name any
+ * branch, and its caller and checkout then come from there; when the payload doesn't say which
+ * branch is the default, the run is taken to be on it.
+ */
+export function onDefaultBranch(ref, defaultBranch) {
+    if (ref === undefined || defaultBranch === undefined)
+        return true;
+    return ref === `refs/heads/${defaultBranch}`;
+}
+//# sourceMappingURL=schedule.js.map

package/dist/jobs/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../src/jobs/schedule.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,GAAG,CAAC,CAAC;AAEjB,MAAM,UAAU,KAAK,CAAC,OAAgB,EAAE,KAAa,EAAE,GAAS;IAC9D,IAAI,KAAK,KAAK,mBAAmB;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,OAAO,KAAK,OAAO,IAAI,GAAG,CAAC,SAAS,EAAE,KAAK,MAAM,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAuB,EACvB,aAAiC;IAEjC,IAAI,GAAG,KAAK,SAAS,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAClE,OAAO,GAAG,KAAK,cAAc,aAAa,EAAE,CAAC;AAC/C,CAAC"}