@angelmsger/fx 0.0.0-stage → 0.11.0

package/dist/domain/release/errors.js

@@ -0,0 +1,57 @@
+// Unresolved issues first seen inside the window. The tracker answers with
+// activity, so first-seen is judged here; see "Unresolved errors" in
+// docs/design/release.md.
+import { releaseFinding } from './types.js';
+import { windowMs } from './window.js';
+// More new issues than this are not a list a person reads; the tracker is
+// asked for no more, and says whether it had more.
+export const ISSUE_CEILING = 1000;
+export function errorsFinding(input) {
+    const floor = input.now.getTime() - windowMs(input.since);
+    const dated = input.issues.flatMap((issue) => {
+        const at = issue.firstSeen === null ? NaN : Date.parse(issue.firstSeen);
+        return Number.isNaN(at) ? [] : [{ issue, at }];
+    });
+    const fresh = dated.filter((d) => d.at >= floor).map((d) => d.issue);
+    const undated = input.issues.length - dated.length;
+    const evidence = {
+        env: input.env,
+        slug: input.slug,
+        since: input.since,
+        capped: input.capped,
+        undated,
+        issues: fresh.map((i) => ({
+            short_id: i.shortId,
+            title: i.title,
+            level: i.level,
+            first_seen: i.firstSeen,
+            last_seen: i.lastSeen,
+            count: i.count,
+            url: i.url,
+        })),
+    };
+    const [level, said] = verdict(input, fresh.length, undated);
+    const message = `${said} (${input.label})`;
+    return releaseFinding('errors', input.repo, level, message, {
+        evidence,
+        coverage: input.capped || undated > 0 ? 'incomplete' : 'checked',
+    });
+}
+function verdict(input, fresh, undated) {
+    const window = `first seen in ${input.env} in the last ${input.since}`;
+    if (fresh > 0) {
+        const floor = input.capped ? 'at least ' : '';
+        return ['fail', `${floor}${fresh} unresolved issue${fresh === 1 ? '' : 's'} ${window}`];
+    }
+    // Without a first-seen date nothing can be said about when it appeared.
+    if (undated > 0)
+        return [
+            'warn',
+            `${undated} unresolved issue${undated === 1 ? '' : 's'} in ${input.env} undated`,
+        ];
+    // The tracker stopped at the ceiling: what it did not send is unread, not absent.
+    if (input.capped)
+        return ['warn', `more unresolved issues than fx asked for; none of them ${window}`];
+    return ['ok', `no unresolved issue ${window}`];
+}
+//# sourceMappingURL=errors.js.map

package/dist/domain/release/errors.js.map

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

package/dist/domain/release/merge.js

@@ -0,0 +1,78 @@
+// Whether the branches a release moves between agree in both directions, from
+// people's commits alone; see "Merge agreement" in docs/design/release.md.
+import { findByGitName } from '../members/resolve.js';
+import { releaseFinding, } from './types.js';
+const MERGE_SUBJECT = /^(Merge pull request #|Pull request #|Merge branch |Merge remote-tracking branch )/;
+export function judgeMerge(input) {
+    const { repo, source, target } = input;
+    const seen = [...(input.ahead.commits ?? []), ...(input.behind.commits ?? [])];
+    const ahead = peopleCommits(input.ahead.commits ?? [], input.bots);
+    const behind = peopleCommits(input.behind.commits ?? [], input.bots);
+    const attribute = (c) => attributed(input.members, c);
+    const unknown = [
+        ...(input.ahead.commits === undefined ? [`${target}..${source}`] : []),
+        ...(input.behind.commits === undefined ? [`${source}..${target}`] : []),
+    ];
+    const evidence = {
+        source,
+        target,
+        ahead: ahead.map(attribute),
+        behind: behind.map(attribute),
+        filtered: seen.length - ahead.length - behind.length,
+        unknown,
+    };
+    const diverged = [
+        ...(ahead.length === 0
+            ? []
+            : [`${count(ahead.length)} on ${source} not merged into ${target}`]),
+        ...(behind.length === 0
+            ? []
+            : [`${count(behind.length)} on ${target} not merged back into ${source}`]),
+    ];
+    // A direction nobody could compare does not undo what the other one saw.
+    const unanswered = unknown.map((range, i) => `could not compare ${range}: ${reasonOf(input, i)}`);
+    if (diverged.length > 0)
+        return releaseFinding('merge', repo, 'fail', [...diverged, ...unanswered].join(', and '), {
+            evidence,
+            coverage: unknown.length > 0 ? 'incomplete' : 'checked',
+        });
+    if (unanswered.length > 0)
+        return releaseFinding('merge', repo, 'warn', unanswered.join(', and '), {
+            evidence,
+            coverage: 'incomplete',
+        });
+    return releaseFinding('merge', repo, 'ok', `${source} and ${target} agree`, { evidence });
+}
+function reasonOf(input, index) {
+    const reasons = [
+        ...(input.ahead.commits === undefined ? [input.ahead.reason] : []),
+        ...(input.behind.commits === undefined ? [input.behind.reason] : []),
+    ];
+    return reasons[index] ?? 'no reason given';
+}
+// Merge commits and bot commits are noise on what changed; people's commits are the evidence.
+export function peopleCommits(commits, bots) {
+    const ignored = new Set(bots.map((b) => b.toLowerCase()));
+    return commits.filter((c) => c.parents.length <= 1 &&
+        !MERGE_SUBJECT.test(c.message) &&
+        !ignored.has(c.author.toLowerCase()));
+}
+export function attributed(members, c) {
+    return { sha: c.sha, author: authorOf(members, c.author), date: c.date, message: c.message };
+}
+export function unmergedOf(commits) {
+    return {
+        commits: commits.length,
+        authors: new Set(commits.map((c) => c.author.id ?? c.author.name)).size,
+    };
+}
+function authorOf(members, name) {
+    const person = members === undefined ? undefined : findByGitName(members, name);
+    return person === undefined
+        ? { id: null, name }
+        : { id: person.id, name: person.display ?? person.id };
+}
+function count(n) {
+    return `${n} commit${n === 1 ? '' : 's'}`;
+}
+//# sourceMappingURL=merge.js.map

package/dist/domain/release/merge.js.map

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

package/dist/domain/release/policy.js

@@ -0,0 +1,40 @@
+// What "a release" means for one repository, resolved from the manifest alone
+// so a personal checkout override cannot change a team report; see "Policy
+// resolution" in docs/design/release.md.
+export const DEFAULT_TARGETS = ['main', 'master'];
+export const DEFAULT_SINCE = '14d';
+// A repository the manifest does not list (a machine-local one) is never on
+// the checklist.
+const OFF = {
+    covered: false,
+    source: undefined,
+    targets: DEFAULT_TARGETS,
+    env: undefined,
+    since: DEFAULT_SINCE,
+    ci: undefined,
+    bots: [],
+    note: undefined,
+};
+export function releasePolicyOf(workspace, name) {
+    const repo = workspace.repos.find((r) => r.name === name);
+    if (repo === undefined)
+        return OFF;
+    const shared = workspace.release ?? {};
+    const own = repo.release ?? {};
+    return {
+        covered: own.covered ?? true,
+        source: own.source ?? shared.source ?? repo.branch ?? workspace.defaults.branch,
+        targets: own.target === undefined ? (shared.targets ?? DEFAULT_TARGETS) : [own.target],
+        env: shared.env,
+        since: shared.since ?? DEFAULT_SINCE,
+        ci: ciEnvsOf(shared, own),
+        bots: shared.bots ?? [],
+        note: own.note,
+    };
+}
+function ciEnvsOf(shared, own) {
+    const sourceEnv = own.ci?.source_env ?? shared.ci?.source_env;
+    const targetEnv = own.ci?.target_env ?? shared.ci?.target_env;
+    return sourceEnv === undefined || targetEnv === undefined ? undefined : { sourceEnv, targetEnv };
+}
+//# sourceMappingURL=policy.js.map

package/dist/domain/release/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/domain/release/policy.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2EAA2E;AAC3E,yCAAyC;AAoBzC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAU,CAAC;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAEnC,4EAA4E;AAC5E,iBAAiB;AACjB,MAAM,GAAG,GAAkB;IACzB,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,eAAe;IACxB,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,aAAa;IACpB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,SAAS;CAChB,CAAC;AAKF,MAAM,UAAU,eAAe,CAAC,SAAoB,EAAE,IAAY;IAChE,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC1D,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACnC,MAAM,MAAM,GAAW,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAQ,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACpC,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;QAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM;QAC/E,OAAO,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;QACtF,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,aAAa;QACpC,EAAE,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;QACvB,IAAI,EAAE,GAAG,CAAC,IAAI;KACf,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,MAAc,EAAE,GAAQ;IACxC,MAAM,SAAS,GAAG,GAAG,CAAC,EAAE,EAAE,UAAU,IAAI,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC;IAC9D,MAAM,SAAS,GAAG,GAAG,CAAC,EAAE,EAAE,UAAU,IAAI,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC;IAC9D,OAAO,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AACnG,CAAC"}

package/dist/domain/release/types.js

@@ -0,0 +1,18 @@
+// The four things a release checklist asks of a repository, as the groups
+// of a report whose ids are repository names, and what each repository's
+// release would carry, so a verdict always names what it was about.
+import { finding } from '../report.js';
+export const CHECKS = ['deps', 'merge', 'ci', 'errors'];
+export function releaseFinding(check, repo, level, message, extra = {}) {
+    return finding(check, repo, level, message, extra);
+}
+// The check could not be made for a reason a person can act on: a tool
+// that is not ready, a platform that did not answer.
+export function unanswered(check, repo, reason, extra = {}) {
+    return releaseFinding(check, repo, 'warn', reason, { ...extra, coverage: 'incomplete' });
+}
+// The check does not apply to this repository; saying why is the answer.
+export function notChecked(check, repo, why) {
+    return releaseFinding(check, repo, 'ok', `${why}, not checked`, { coverage: 'not_applicable' });
+}
+//# sourceMappingURL=types.js.map

package/dist/domain/release/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domain/release/types.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AACzE,oEAAoE;AAEpE,OAAO,EAAE,OAAO,EAA4D,MAAM,cAAc,CAAC;AAEjG,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAU,CAAC;AA+DjE,MAAM,UAAU,cAAc,CAC5B,KAAY,EACZ,IAAY,EACZ,KAAY,EACZ,OAAe,EACf,QAAsB,EAAE;IAExB,OAAO,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,uEAAuE;AACvE,qDAAqD;AACrD,MAAM,UAAU,UAAU,CACxB,KAAY,EACZ,IAAY,EACZ,MAAc,EACd,QAAsB,EAAE;IAExB,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,IAAY,EAAE,GAAW;IAChE,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,eAAe,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAClG,CAAC"}

package/dist/domain/release/version.js

@@ -0,0 +1,133 @@
+// The version a repository declares for itself, read from the same dependency file
+// the deps check reads. It finds the version a person wrote, it does not run the build
+// that might compute another one; TOML is parsed, and comments never count.
+import { parse } from 'smol-toml';
+// A Gradle build often keeps its version beside the build file.
+export const GRADLE_PROPERTIES = 'gradle.properties';
+export const VERSION_READERS = {
+    'package.json': packageVersion,
+    'pyproject.toml': pyprojectVersion,
+    'pom.xml': pomVersion,
+    'build.gradle': gradleVersion,
+    'build.gradle.kts': gradleVersion,
+    [GRADLE_PROPERTIES]: propertiesVersion,
+};
+export function declaredVersion(file, text) {
+    const reader = VERSION_READERS[file];
+    if (reader === undefined)
+        return undefined;
+    const version = reader(text)?.trim();
+    return version === undefined || version === '' ? undefined : version;
+}
+function packageVersion(text) {
+    try {
+        const doc = JSON.parse(text);
+        if (typeof doc !== 'object' || doc === null)
+            return undefined;
+        const version = doc['version'];
+        return typeof version === 'string' ? version : undefined;
+    }
+    catch {
+        // The deps check reports a broken file; a version it cannot read is just unknown.
+        return undefined;
+    }
+}
+// [project] is the standard table; Poetry projects keep theirs under [tool.poetry].
+function pyprojectVersion(text) {
+    let doc;
+    try {
+        doc = parse(text);
+    }
+    catch {
+        // A file that is not TOML declares nothing fx can read.
+        return undefined;
+    }
+    return stringAt(doc, ['project', 'version']) ?? stringAt(doc, ['tool', 'poetry', 'version']);
+}
+function stringAt(doc, path) {
+    let at = doc;
+    for (const key of path)
+        at = typeof at === 'object' && at !== null ? at[key] : undefined;
+    return typeof at === 'string' ? at : undefined;
+}
+// The project's own <version>, else the one it inherits from <parent>; a single
+// ${property} is resolved from the project's <properties>, as CI-friendly versions use.
+function pomVersion(text) {
+    const values = pomValues(text);
+    const version = values.get('project/version') ?? values.get('project/parent/version');
+    const property = version === undefined ? undefined : /^\$\{([\w.-]+)\}$/.exec(version)?.[1];
+    if (property === undefined)
+        return version;
+    return values.get(`project/properties/${property}`) ?? version;
+}
+// The text of every element, keyed by its path from the root.
+function pomValues(text) {
+    const values = new Map();
+    const path = [];
+    const body = text.replace(/<!--[\s\S]*?-->/g, '').replace(/<\?[\s\S]*?\?>/g, '');
+    const TAG = /<(\/?)([\w.:-]+)[^>]*?(\/?)>|([^<]+)/g;
+    for (const match of body.matchAll(TAG)) {
+        const [, closing, name, selfClosing, content] = match;
+        if (content !== undefined) {
+            const value = content.trim();
+            if (value !== '' && path.length > 0 && !values.has(path.join('/')))
+                values.set(path.join('/'), value);
+        }
+        else if (name !== undefined && selfClosing !== '/') {
+            if (closing === '/')
+                path.pop();
+            else
+                path.push(name);
+        }
+    }
+    return values;
+}
+// `version = '1.2.3'` (Groovy also allows `version '1.2.3'`) at the top level of the build.
+function gradleVersion(text) {
+    for (const line of withoutComments(text).split('\n'))
+        if (!line.startsWith(' ') && !line.startsWith('\t')) {
+            const version = /^version\s*=?\s*["']([^"']+)["']/.exec(line)?.[1];
+            if (version !== undefined)
+                return version;
+        }
+    return undefined;
+}
+// A build script without its // and /* */ comments; a string such as '**/*.java' keeps
+// what looks like one, and a block comment keeps its line breaks.
+function withoutComments(text) {
+    let kept = '';
+    let quote;
+    for (let i = 0; i < text.length; i += 1) {
+        const c = text[i] ?? '';
+        if (quote !== undefined) {
+            const escaped = c === '\\' ? (text[i + 1] ?? '') : '';
+            kept += c + escaped;
+            i += escaped.length;
+            if (c === quote)
+                quote = undefined;
+        }
+        else if (c === '"' || c === "'") {
+            quote = c;
+            kept += c;
+        }
+        else if (text.startsWith('//', i) || text.startsWith('/*', i)) {
+            const block = text[i + 1] === '*';
+            const end = block ? text.indexOf('*/', i + 2) : text.indexOf('\n', i);
+            const stop = end === -1 ? text.length : end + (block ? 2 : 0);
+            kept += block ? text.slice(i, stop).replace(/[^\n]/g, '') : '';
+            i = stop - 1;
+        }
+        else
+            kept += c;
+    }
+    return kept;
+}
+function propertiesVersion(text) {
+    for (const line of text.split('\n')) {
+        const version = /^\s*version\s*[=:]\s*(\S+)\s*$/.exec(line)?.[1];
+        if (version !== undefined)
+            return version;
+    }
+    return undefined;
+}
+//# sourceMappingURL=version.js.map

package/dist/domain/release/version.js.map

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

package/dist/domain/release/window.js

@@ -0,0 +1,28 @@
+// A look-back window as people write it (`14d`, `48h`, `2w`), in milliseconds.
+import { DevkitError } from '../errors.js';
+const UNIT_MS = {
+    h: 60 * 60 * 1000,
+    d: 24 * 60 * 60 * 1000,
+    w: 7 * 24 * 60 * 60 * 1000,
+};
+const PATTERN = /^(\d+)([hdw])$/;
+export function parseWindow(text) {
+    const m = PATTERN.exec(text.trim());
+    if (m === null || m[1] === undefined || m[2] === undefined)
+        return undefined;
+    const amount = Number(m[1]);
+    return amount === 0 ? undefined : amount * (UNIT_MS[m[2]] ?? 0);
+}
+export function isWindow(text) {
+    return parseWindow(text) !== undefined;
+}
+export function windowMs(text) {
+    const ms = parseWindow(text);
+    if (ms !== undefined)
+        return ms;
+    throw new DevkitError('usage', 'BAD_SINCE', `"${text}" is not a window`, {
+        hint: 'Write an amount and a unit: 14d, 48h, 2w.',
+        nextSteps: ['fx release check --since 14d'],
+    });
+}
+//# sourceMappingURL=window.js.map

package/dist/domain/release/window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","sourceRoot":"","sources":["../../../src/domain/release/window.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,OAAO,GAAqC;IAChD,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IACjB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IACtB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;CAC3B,CAAC;AAEF,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAEjC,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7E,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,mBAAmB,EAAE;QACvE,IAAI,EAAE,2CAA2C;QACjD,SAAS,EAAE,CAAC,8BAA8B,CAAC;KAC5C,CAAC,CAAC;AACL,CAAC"}

package/dist/domain/report.js

@@ -0,0 +1,42 @@
+// Aggregate diagnostic severity and coverage. Workflows decide preparation
+// readiness and exit status separately from this report's ok/complete flags.
+export function finding(group, id, level, message, extra = {}) {
+    return {
+        group,
+        id,
+        level,
+        coverage: extra.coverage ?? 'checked',
+        message,
+        ...(extra.fix === undefined ? {} : { fix: extra.fix }),
+        ...(extra.handoff === undefined ? {} : { handoff: extra.handoff }),
+        ...(extra.evidence === undefined ? {} : { evidence: extra.evidence }),
+        ...(extra.required === undefined ? {} : { required: extra.required }),
+        ...(extra.actions === undefined ? {} : { actions: extra.actions }),
+    };
+}
+export function summarize(findings) {
+    const summary = { ok: 0, warn: 0, fail: 0 };
+    for (const f of findings)
+        summary[f.level] += 1;
+    return summary;
+}
+// Findings in the groups' declared order, each group keeping its own order,
+// so the report reads the same whichever check answered first.
+export function orderBy(groups, findings) {
+    return groups.flatMap((group) => findings.filter((f) => f.group === group));
+}
+export function report(groups, findings) {
+    const ordered = orderBy(groups, findings);
+    return {
+        ok: ordered.every((f) => f.level !== 'fail'),
+        complete: ordered.every((f) => f.coverage !== 'incomplete'),
+        summary: summarize(ordered),
+        findings: ordered,
+    };
+}
+export function worst(levels) {
+    if (levels.includes('fail'))
+        return 'fail';
+    return levels.includes('warn') ? 'warn' : 'ok';
+}
+//# sourceMappingURL=report.js.map

package/dist/domain/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/domain/report.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,6EAA6E;AA0C7E,MAAM,UAAU,OAAO,CACrB,KAAQ,EACR,EAAU,EACV,KAAY,EACZ,OAAe,EACf,QAAsB,EAAE;IAExB,OAAO;QACL,KAAK;QACL,EAAE;QACF,KAAK;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,SAAS;QACrC,OAAO;QACP,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;QACtD,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAClE,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAA4B;IACpD,MAAM,OAAO,GAA0B,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACnE,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4EAA4E;AAC5E,+DAA+D;AAC/D,MAAM,UAAU,OAAO,CACrB,MAAoB,EACpB,QAA+B;IAE/B,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,MAAoB,EACpB,QAA+B;IAE/B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1C,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC;QAC5C,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC;QAC3D,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC;QAC3B,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,MAAwB;IAC5C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC"}

package/dist/domain/semver.js

@@ -0,0 +1,65 @@
+// @ts-check
+// Just enough semver for version floors: parse, compare, and tell a release
+// from a development build. A prerelease or 0.0.0 is a development build.
+// JavaScript, because the release gate runs it before there is a build.
+/**
+ * @typedef {{ major: number, minor: number, patch: number, prerelease?: string }} Semver
+ */
+const PATTERN = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+/**
+ * @param {string} text
+ * @returns {Semver | undefined}
+ */
+export function parseSemver(text) {
+    const m = PATTERN.exec(text.trim());
+    if (m === null)
+        return undefined;
+    const base = { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) };
+    return m[4] === undefined ? base : { ...base, prerelease: m[4] };
+}
+/**
+ * @param {string} text
+ * @returns {boolean}
+ */
+export function isSemver(text) {
+    return parseSemver(text) !== undefined;
+}
+/**
+ * @param {Semver} a
+ * @param {Semver} b
+ * @returns {number}
+ */
+export function compareSemver(a, b) {
+    for (const part of /** @type {const} */ (['major', 'minor', 'patch'])) {
+        if (a[part] !== b[part])
+            return a[part] < b[part] ? -1 : 1;
+    }
+    if (a.prerelease === b.prerelease)
+        return 0;
+    if (a.prerelease === undefined)
+        return 1;
+    if (b.prerelease === undefined)
+        return -1;
+    return a.prerelease < b.prerelease ? -1 : 1;
+}
+/**
+ * @param {string} text
+ * @returns {boolean}
+ */
+export function isRelease(text) {
+    const v = parseSemver(text);
+    return v !== undefined && v.prerelease === undefined && (v.major | v.minor | v.patch) !== 0;
+}
+/**
+ * @param {string} version
+ * @param {string} floor
+ * @returns {boolean}
+ */
+export function atLeast(version, floor) {
+    const v = parseSemver(version);
+    const f = parseSemver(floor);
+    if (v === undefined || f === undefined)
+        return false;
+    return compareSemver(v, f) >= 0;
+}
+//# sourceMappingURL=semver.js.map

package/dist/domain/semver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.js","sourceRoot":"","sources":["../../src/domain/semver.js"],"names":[],"mappings":"AAAA,YAAY;AACZ,4EAA4E;AAC5E,0EAA0E;AAC1E,wEAAwE;AAExE;;GAEG;AAEH,MAAM,OAAO,GAAG,oEAAoE,CAAC;AAErF;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAI;IAC9B,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAI;IAC3B,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,CAAC,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,oBAAoB,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;QACtE,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU;QAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,OAAO,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAI;IAC5B,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC9F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,OAAO,EAAE,KAAK;IACpC,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/domain/setup/failure-case.js

@@ -0,0 +1,11 @@
+// Which of a recipe's failure cases a failed check answers to. Nothing from the output
+// is quoted: a case only names a cause its recipe wrote down beforehand.
+export function failureCaseOf(output, cases = []) {
+    return cases.find((candidate) => (candidate.exitCode === undefined || candidate.exitCode === output.code) &&
+        answers(candidate.stdout, output.stdout) &&
+        answers(candidate.stderr, output.stderr));
+}
+function answers(pattern, text) {
+    return pattern === undefined || new RegExp(pattern).test(text);
+}
+//# sourceMappingURL=failure-case.js.map

package/dist/domain/setup/failure-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-case.js","sourceRoot":"","sources":["../../../src/domain/setup/failure-case.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,yEAAyE;AAUzE,MAAM,UAAU,aAAa,CAC3B,MAAmB,EACnB,QAAgC,EAAE;IAElC,OAAO,KAAK,CAAC,IAAI,CACf,CAAC,SAAS,EAAE,EAAE,CACZ,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,MAAM,CAAC,IAAI,CAAC;QACxE,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACxC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,OAA2B,EAAE,IAAY;IACxD,OAAO,OAAO,KAAK,SAAS,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC"}

package/dist/domain/setup/json-check.js

@@ -0,0 +1,29 @@
+// Status commands can exit successfully while reporting an unusable state.
+// Only the declared scalar is compared, and only a declared reason field is ever quoted;
+// nothing else in a response becomes a diagnostic.
+export function matchesJson(text, expectation) {
+    return valueAt(text, expectation.path) === expectation.equals;
+}
+export function statedReason(text, expectation) {
+    if (expectation.reason === undefined)
+        return undefined;
+    const reason = valueAt(text, expectation.reason);
+    return typeof reason === 'string' && reason.trim() !== '' ? reason.trim() : undefined;
+}
+// `undefined` stands for an unreadable response as well as an absent field.
+function valueAt(text, path) {
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+    for (const part of path.split('.')) {
+        if (typeof value !== 'object' || value === null || !Object.hasOwn(value, part))
+            return undefined;
+        value = value[part];
+    }
+    return value;
+}
+//# sourceMappingURL=json-check.js.map

package/dist/domain/setup/json-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-check.js","sourceRoot":"","sources":["../../../src/domain/setup/json-check.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yFAAyF;AACzF,mDAAmD;AAInD,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,WAA4B;IACpE,OAAO,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,MAAM,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,WAA4B;IACrE,IAAI,WAAW,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACxF,CAAC;AAED,4EAA4E;AAC5E,SAAS,OAAO,CAAC,IAAY,EAAE,IAAY;IACzC,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;YAC5E,OAAO,SAAS,CAAC;QACnB,KAAK,GAAI,KAAiC,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}