@svp-labs/talos 0.0.0 → 0.1.0

package/dist/cli/self-test.js

@@ -0,0 +1,127 @@
+import { existsSync } from 'node:fs';
+import { cp, mkdtemp, readdir, readFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, relative, resolve } from 'node:path';
+import { z } from 'zod';
+import { parse } from './io.js';
+import { currentOs } from './run.js';
+import { ConfigError, loadConfig } from '../config/load.js';
+import { runAt } from '../engine/local.js';
+import { createEngine } from '../engine/session.js';
+import { execOk } from '../exec/exec.js';
+const expectation = z.object({
+    checks: z.array(z.string()).min(1),
+    rules: z.array(z.string()).default([]),
+    clean: z.boolean().default(false),
+    os: z.array(z.enum(['linux', 'windows', 'macos'])).default(['linux']),
+});
+async function findCases(root) {
+    const entries = await readdir(root, { recursive: true });
+    return entries
+        .filter((entry) => entry.endsWith('expect.json') && !entry.includes('node_modules'))
+        .map((entry) => join(root, entry, '..'))
+        .sort((a, b) => a.localeCompare(b));
+}
+async function freshRepo(engine, source) {
+    const directory = await mkdtemp(join(tmpdir(), 'talos-case-'));
+    await cp(source, directory, { recursive: true, filter: (path) => !path.endsWith('expect.json') });
+    const git = async (...args) => {
+        await execOk(engine.exec, 'git', args, { cwd: directory });
+    };
+    await git('init', '--quiet', '--initial-branch=main');
+    await git('add', '--all');
+    await git('-c', 'user.name=Talos', '-c', 'user.email=talos@example.invalid', '-c', 'commit.gpgsign=false', 'commit', '--quiet', '--message', '[T-1]: Seed the test project');
+    return directory;
+}
+/**
+ * The operating systems `expect.json` lists beyond Linux that no component of the case's
+ * `talos.yml` declares: no component check is planned there, so the case can't pass on them.
+ * A `talos.yml` that can't be read lists none; the case's run reports it.
+ */
+export async function undeclaredOses(source, expected) {
+    let config;
+    try {
+        config = await loadConfig(source);
+    }
+    catch (error) {
+        if (error instanceof ConfigError)
+            return [];
+        throw error;
+    }
+    return expected.os.filter((os) => os !== 'linux' && !config.components.some((c) => c.os.includes(os)));
+}
+/** What went wrong with one case, or nothing. */
+export function assess(expected, result) {
+    const problems = result.outcomes
+        .filter((o) => o.status === 'error')
+        .map((o) => `engine error in ${o.check}: ${o.reason ?? ''}`);
+    const ran = new Set(result.outcomes.filter((o) => o.status !== 'skipped').map((o) => o.check));
+    for (const check of expected.checks.filter((c) => !ran.has(c))) {
+        const skipped = result.outcomes.find((o) => o.check === check);
+        const why = skipped?.reason === undefined ? '' : `: ${skipped.reason}`;
+        problems.push(`${check} did not run${why}`);
+    }
+    const rules = new Set(result.outcomes.flatMap((o) => o.findings.map((f) => f.rule)));
+    for (const rule of expected.rules.filter((r) => !rules.has(r))) {
+        problems.push(`no ${rule} finding`);
+    }
+    if (expected.clean && rules.size > 0) {
+        problems.push(`expected no findings, got ${[...rules].join(', ')}`);
+    }
+    return problems;
+}
+/**
+ * Runs one case in a fresh repository: what went wrong, or nothing when it isn't for this OS. A
+ * case expecting an OS its `talos.yml` declares no component on fails on every OS.
+ */
+async function runCase(engine, source, expected, os) {
+    const undeclared = await undeclaredOses(source, expected);
+    if (undeclared.length > 0) {
+        return [`expect.json lists ${undeclared.join(', ')}, which no component in talos.yml runs on`];
+    }
+    if (!expected.os.includes(os))
+        return undefined;
+    const directory = await freshRepo(engine, source);
+    try {
+        const sha = (await execOk(engine.exec, 'git', ['rev-parse', 'HEAD'], { cwd: directory })).trim();
+        const at = { root: directory, sha, os, side: 'alone', only: expected.checks };
+        return await runAt(engine, { ...at, tiers: ['commit', 'head'] }).then((result) => assess(expected, result), (error) => [
+            `engine error: ${error instanceof Error ? error.message : String(error)}`,
+        ]);
+    }
+    finally {
+        await rm(directory, { recursive: true, force: true });
+    }
+}
+/**
+ * `talos self-test <dir>`: runs each test project's checks with this engine and compares the
+ * findings with the project's `expect.json`.
+ */
+export const selfTest = async (argv, io) => {
+    const { values, positionals } = parse(argv, { only: { type: 'string' }, verbose: { type: 'boolean', default: false } }, true);
+    const root = resolve(io.cwd, positionals[0] ?? 'test-projects');
+    // The runtime cases read recorded vendor feeds, so the self-test doesn't drift with the network.
+    const feeds = join(root, 'runtime', 'feeds');
+    if (process.env.TALOS_RUNTIME_FEEDS === undefined && existsSync(feeds)) {
+        process.env.TALOS_RUNTIME_FEEDS = feeds;
+    }
+    const engine = createEngine(values.verbose);
+    const os = currentOs();
+    let failed = 0;
+    for (const source of await findCases(root)) {
+        const name = relative(root, source);
+        if (values.only !== undefined && !name.startsWith(values.only))
+            continue;
+        const expected = expectation.parse(JSON.parse(await readFile(join(source, 'expect.json'), 'utf8')));
+        const problems = await runCase(engine, source, expected, os);
+        if (problems === undefined)
+            continue;
+        failed += problems.length > 0 ? 1 : 0;
+        const mark = problems.length > 0 ? 'FAIL' : 'ok  ';
+        const detail = problems.map((p) => `     ${p}\n`).join('');
+        io.out(`${mark} ${name}\n${detail}`);
+    }
+    io.out(failed > 0 ? `${failed} case(s) failed\n` : 'all cases passed\n');
+    return failed > 0 ? 1 : 0;
+};
+//# sourceMappingURL=self-test.js.map

package/dist/cli/self-test.js.map

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

package/dist/cli/shrinkwrap.js

@@ -0,0 +1,20 @@
+import { writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { parse, required, UsageError } from './io.js';
+import { shrinkwrapOf } from '../version/shrinkwrap.js';
+/**
+ * `talos shrinkwrap <dir> --out <file>`: the `npm-shrinkwrap.json` a release ships, from a hoisted
+ * install of Talos's production dependencies in `dir`, beside its `package.json` and lockfile. The
+ * release job runs it before packing.
+ */
+export const shrinkwrap = async (argv, io) => {
+    const { values, positionals } = parse(argv, { out: { type: 'string' } }, true);
+    const [dir, ...extra] = positionals;
+    if (dir === undefined || extra.length > 0)
+        throw new UsageError('give one directory');
+    const out = resolve(io.cwd, required(values.out, 'out'));
+    const wrap = await shrinkwrapOf(resolve(io.cwd, dir));
+    await writeFile(out, `${JSON.stringify(wrap, null, 2)}\n`);
+    return 0;
+};
+//# sourceMappingURL=shrinkwrap.js.map

package/dist/cli/shrinkwrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shrinkwrap.js","sourceRoot":"","sources":["../../src/cli/shrinkwrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAgB,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAY,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;IACpD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/E,MAAM,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,WAAW,CAAC;IACpC,IAAI,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACtF,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,SAAS,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC;AACX,CAAC,CAAC"}

package/dist/cli/status.js

@@ -0,0 +1,39 @@
+import { parse, UsageError } from './io.js';
+import { exec } from '../exec/exec.js';
+import { github, tokenFromEnvironment } from '../github/api.js';
+import { identities } from '../github/identities.js';
+import { currentRepository, isRepoName } from '../github/remote.js';
+import { orgStatus, statusContext, statusOf } from '../status/collect.js';
+import { statusText } from '../status/text.js';
+import { lookupMode } from '../version/pin.js';
+/**
+ * `talos status [--repo owner/name]... [--org] [--json]`: each repository's state, read from
+ * GitHub. `--json` prints an array of `talos.status/1` objects, one per repository, on one line.
+ * Exits 1 when a repository couldn't be read; its object then carries `error`.
+ */
+export const status = async (argv, io) => {
+    const { values } = parse(argv, {
+        repo: { type: 'string', multiple: true },
+        org: { type: 'boolean', default: false },
+        json: { type: 'boolean', default: false },
+    });
+    const named = values.repo ?? [];
+    if (values.org && named.length > 0)
+        throw new UsageError('--org and --repo exclude each other');
+    const invalid = named.find((repo) => !isRepoName(repo));
+    if (invalid !== undefined)
+        throw new UsageError(`--repo takes owner/name, not "${invalid}"`);
+    let repos = named;
+    if (!values.org && repos.length === 0) {
+        const here = await currentRepository(io.env, io.cwd, exec);
+        if (here === undefined) {
+            throw new UsageError('no GitHub repository here: pass --repo owner/name or --org');
+        }
+        repos = [here];
+    }
+    const ctx = statusContext(github(await tokenFromEnvironment(io.env)), identities(io.env), lookupMode(io.env));
+    const statuses = values.org ? await orgStatus(ctx) : await statusOf(ctx, repos);
+    io.out(values.json ? `${JSON.stringify(statuses)}\n` : statusText(statuses));
+    return statuses.some((s) => 'error' in s) ? 1 : 0;
+};
+//# sourceMappingURL=status.js.map

package/dist/cli/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAY,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;IAChD,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE;QAC7B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;QACxC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;KAC1C,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,IAAI,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;IAChG,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,UAAU,CAAC,iCAAiC,OAAO,GAAG,CAAC,CAAC;IAC7F,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,UAAU,CAAC,4DAA4D,CAAC,CAAC;QACrF,CAAC;QACD,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,MAAM,GAAG,GAAG,aAAa,CACvB,MAAM,CAAC,MAAM,oBAAoB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAC1C,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,EAClB,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,CACnB,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChF,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7E,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC,CAAC"}

package/dist/cli/ticket.js

@@ -0,0 +1,180 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { parse, required, UsageError } from './io.js';
+import { github, repoFromRemote, tokenFromEnvironment } from '../github/api.js';
+import { identities } from '../github/identities.js';
+import { agentProblem, claim, reasonProblem, release, } from '../ticket/claim.js';
+import { configAt, defaultBranch } from '../ticket/github.js';
+import { CLAIM_SCHEMA, TICKET_SCHEMA } from '../ticket/payload.js';
+import { next } from '../ticket/queue.js';
+import { sweepStaleClaims } from '../ticket/stale.js';
+import { ticketStatus } from '../ticket/status.js';
+/**
+ * Exit codes of `talos ticket`:
+ * - 0: done (claimed, released, status printed);
+ * - 1: refused: the issue is missing, a pull request or closed, or nobody holds it and its labels
+ *   keep it from being claimed (not `status/ready`, blocked, an epic…), or a PR is open from its
+ *   branch so it can't be released;
+ * - 2: an error (GitHub, configuration);
+ * - 3: someone else holds the claim already, whatever the open issue's labels say (a usage error
+ *   exits 3 too; the JSON tells them apart);
+ * - 4: `next` claimed nothing: the open claims reach `agents.max_claims`, or no ticket in the
+ *   queue could be claimed.
+ */
+export const TICKET_EXIT = { done: 0, refused: 1, taken: 3, nothing: 4 };
+const REPO = /^[\w.-]+\/[\w.-]+$/;
+async function repoOf(value, io) {
+    const named = value ?? io.env.GITHUB_REPOSITORY ?? io.env.GH_REPO;
+    if (named !== undefined && named !== '') {
+        if (!REPO.test(named))
+            throw new UsageError(`--repo takes owner/name, not ${named}`);
+        return named;
+    }
+    const remote = await promisify(execFile)('git', ['remote', 'get-url', 'origin'], {
+        cwd: io.cwd,
+    }).catch(() => undefined);
+    const fromRemote = remote === undefined ? undefined : repoFromRemote(remote.stdout);
+    if (fromRemote === undefined)
+        throw new UsageError('no repository: pass --repo owner/name');
+    return fromRemote;
+}
+function issueNumber(value) {
+    if (value === undefined || !/^[1-9]\d{0,8}$/.test(value)) {
+        throw new UsageError('an issue number is required');
+    }
+    return Number(value);
+}
+function checked(text, problem) {
+    const found = problem(text);
+    if (found !== undefined)
+        throw new UsageError(found);
+    return text;
+}
+function exitOf(result) {
+    switch (result.result) {
+        case 'refused': {
+            return TICKET_EXIT.refused;
+        }
+        case 'taken': {
+            return TICKET_EXIT.taken;
+        }
+        case 'max-claims':
+        case 'empty': {
+            return TICKET_EXIT.nothing;
+        }
+        default: {
+            return TICKET_EXIT.done;
+        }
+    }
+}
+const USAGE = 'usage: talos ticket claim <issue> --agent <id> | next --agent <id> | ' +
+    'release <issue> --reason <text> | status <issue>   [--repo owner/name] [--json]';
+export function ticketRequest(sub, args) {
+    switch (sub) {
+        case 'claim': {
+            const agent = checked(required(args.agent, 'agent'), agentProblem);
+            return { sub, issue: issueNumber(args.issue), agent };
+        }
+        case 'next': {
+            return { sub, agent: checked(required(args.agent, 'agent'), agentProblem) };
+        }
+        case 'release': {
+            const reason = checked(required(args.reason, 'reason'), reasonProblem);
+            return { sub, issue: issueNumber(args.issue), reason };
+        }
+        case 'status': {
+            return { sub, issue: issueNumber(args.issue) };
+        }
+        default: {
+            throw new UsageError(USAGE);
+        }
+    }
+}
+/**
+ * `talos.claim/1`: a claimed ticket's fields at the top level, or `error` naming why there is
+ * none (`claimed` exits 3, `none` and `max-claims` exit 4, `refused` exits 1).
+ */
+export function claimContract(outcome) {
+    switch (outcome.result) {
+        case 'claimed': {
+            const { result: _result, ticket, ...rest } = outcome;
+            return { schema: CLAIM_SCHEMA, ...rest, ...ticket };
+        }
+        case 'taken': {
+            const { result: _result, ...rest } = outcome;
+            return { schema: CLAIM_SCHEMA, error: 'claimed', ...rest };
+        }
+        case 'empty': {
+            const { result: _result, ...rest } = outcome;
+            return { schema: CLAIM_SCHEMA, error: 'none', ...rest };
+        }
+        case 'max-claims':
+        case 'refused': {
+            const { result, ...rest } = outcome;
+            return { schema: CLAIM_SCHEMA, error: result, ...rest };
+        }
+        case 'released': {
+            const { result: _result, ...rest } = outcome;
+            return { schema: CLAIM_SCHEMA, released: true, ...rest };
+        }
+    }
+}
+async function runRequest(t, request, maxClaims) {
+    switch (request.sub) {
+        case 'status': {
+            return { output: await ticketStatus(t, request.issue), code: TICKET_EXIT.done };
+        }
+        case 'release': {
+            const result = await release(t, request.issue, request.reason);
+            return { output: claimContract({ issue: request.issue, ...result }), code: exitOf(result) };
+        }
+        case 'claim': {
+            const result = await claim(t, request.issue, request.agent);
+            return { output: claimContract({ issue: request.issue, ...result }), code: exitOf(result) };
+        }
+        case 'next': {
+            const swept = await sweepStaleClaims({ gh: t.gh, refs: t.gh }, t);
+            const result = await next(t, request.agent, maxClaims);
+            return { output: { ...claimContract(result), swept: swept.released }, code: exitOf(result) };
+        }
+    }
+}
+/** `talos ticket` with a GitHub client of the caller's choosing (tests pass a fake fetch). */
+export function ticketWith(options) {
+    return async (argv, io) => {
+        const [sub, ...rest] = argv;
+        // Every answer is JSON already, so `--json`, which agents pass to every command, changes
+        // nothing here.
+        const { values, positionals } = parse(rest, {
+            agent: { type: 'string' },
+            reason: { type: 'string' },
+            repo: { type: 'string' },
+            json: { type: 'boolean', default: false },
+        }, true);
+        const request = ticketRequest(sub, {
+            issue: positionals[0],
+            agent: values.agent,
+            reason: values.reason,
+        });
+        const repo = await repoOf(values.repo, io);
+        const gh = github(await tokenFromEnvironment(io.env), options);
+        const config = await configAt(gh, repo, await defaultBranch(gh, repo));
+        const t = {
+            gh,
+            repo,
+            prefix: config.prefix,
+            who: identities(io.env),
+            now: new Date(),
+        };
+        const { output, code } = await runRequest(t, request, config.agents.max_claims);
+        io.out(`${JSON.stringify({ schema: TICKET_SCHEMA, ...output, repo }, null, 2)}\n`);
+        return code;
+    };
+}
+/**
+ * `talos ticket`: the claim protocol, for agents and people alike. Every subcommand prints one
+ * JSON object, with or without `--json`: `talos.claim/1` from `claim`, `next` and `release`, and
+ * `talos.ticket/1` from `status`. `next` first releases claims idle for four hours.
+ */
+export const ticket = ticketWith({});
+//# sourceMappingURL=ticket.js.map

package/dist/cli/ticket.js.map

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

package/dist/cli/verdict.js

@@ -0,0 +1,57 @@
+import { appendFile, readdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse } from './io.js';
+import { loadConfig } from '../config/load.js';
+import { parseRunResult } from '../core/result.js';
+import { commitFindings, comparisonsFor, compactVerdict } from '../engine/gate.js';
+import { gatePlanSchema } from '../engine/plan.js';
+import { annotations, markdownSummary, textReport } from '../engine/report.js';
+import { decide, exitCode } from '../engine/verdict.js';
+import { exec } from '../exec/exec.js';
+import { git } from '../repo/git.js';
+import { toSarif } from '../sarif/sarif.js';
+import { ownVersion } from '../version/self.js';
+async function readResults(directory) {
+    const names = (await readdir(directory, { recursive: true })).filter((n) => n.endsWith('.json'));
+    return Promise.all(names.map(async (name) => parseRunResult(await readFile(join(directory, name), 'utf8'))));
+}
+function prNumber(io) {
+    const match = /^refs\/pull\/(\d+)\//.exec(io.env.GITHUB_REF ?? '');
+    return match?.[1] === undefined ? undefined : Number(match[1]);
+}
+/** `talos verdict`: judges the gate's runs, writes SARIF and the compact verdict, annotates. */
+export const verdict = async (argv, io) => {
+    const { values } = parse(argv, {
+        plan: { type: 'string', default: 'talos-plan.json' },
+        results: { type: 'string', default: 'talos-results' },
+        sarif: { type: 'string', default: 'talos.sarif' },
+        json: { type: 'string', default: 'verdict.json' },
+    });
+    const plan = gatePlanSchema.parse(JSON.parse(await readFile(values.plan, 'utf8')));
+    const repo = git(exec, io.cwd);
+    const config = await loadConfig(io.cwd);
+    const results = await readResults(values.results);
+    const decided = decide(results, await comparisonsFor(repo, plan), await commitFindings(repo, plan, config));
+    const version = ownVersion();
+    await writeFile(values.sarif, `${JSON.stringify(toSarif(decided.findings, version))}\n`);
+    const pr = prNumber(io);
+    const compact = compactVerdict(decided, {
+        talos: version,
+        mode: plan.mode,
+        base: plan.base,
+        head: plan.head,
+        ...(io.env.GITHUB_REPOSITORY ? { repo: io.env.GITHUB_REPOSITORY } : {}),
+        ...(pr === undefined ? {} : { pr }),
+    });
+    await writeFile(values.json, `${JSON.stringify(compact, null, 2)}\n`);
+    io.out(annotations(decided));
+    io.err(textReport(decided));
+    const summary = io.env.GITHUB_STEP_SUMMARY;
+    if (summary !== undefined)
+        await appendFile(summary, markdownSummary(decided));
+    const output = io.env.GITHUB_OUTPUT;
+    if (output !== undefined)
+        await appendFile(output, `engine_error=${decided.faults.length > 0}\n`);
+    return exitCode(decided);
+};
+//# sourceMappingURL=verdict.js.map

package/dist/cli/verdict.js.map

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

package/dist/cli/version.js

@@ -0,0 +1,29 @@
+import { parse, UsageError } from './io.js';
+import { exec } from '../exec/exec.js';
+import { currentRepository, isRepoName } from '../github/remote.js';
+import { enforcedRelease } from '../version/enforced.js';
+import { ownVersion } from '../version/self.js';
+/**
+ * `talos version`: this copy's version. `--enforced [--repo owner/name] --json` instead prints the
+ * release the repository's rulesets pin, `{ version, sha, from }`, which Thea's hub hands to tasks.
+ */
+export const version = async (argv, io) => {
+    const { values } = parse(argv, {
+        enforced: { type: 'boolean', default: false },
+        repo: { type: 'string' },
+        json: { type: 'boolean', default: false },
+    });
+    if (!values.enforced) {
+        io.out(`${ownVersion()}\n`);
+        return 0;
+    }
+    if (values.repo !== undefined && !isRepoName(values.repo)) {
+        throw new UsageError(`--repo takes owner/name, not "${values.repo}"`);
+    }
+    const repo = values.repo ?? (await currentRepository(io.env, io.cwd, exec));
+    const release = await enforcedRelease({ env: io.env, repo });
+    const answer = { schema: 'talos.version/1', repo: repo ?? null, ...release };
+    io.out(values.json ? `${JSON.stringify(answer)}\n` : `${release.version} (${release.sha})\n`);
+    return 0;
+};
+//# sourceMappingURL=version.js.map

package/dist/cli/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/cli/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAY,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;IACjD,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE;QAC7B,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;QAC7C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;KAC1C,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,EAAE,CAAC,GAAG,CAAC,GAAG,UAAU,EAAE,IAAI,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,UAAU,CAAC,iCAAiC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;IAC7E,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IAC9F,OAAO,CAAC,CAAC;AACX,CAAC,CAAC"}

package/dist/cli/why.js

@@ -0,0 +1,96 @@
+import { stat } from 'node:fs/promises';
+import { isAbsolute, join, relative, sep } from 'node:path';
+import { parse, UsageError } from './io.js';
+import { exec } from '../exec/exec.js';
+import { github, tokenFromEnvironment } from '../github/api.js';
+import { currentRepository, isRepoName } from '../github/remote.js';
+import { git } from '../repo/git.js';
+import { commitsFor, SECTIONS, whyFor } from '../status/history.js';
+import { clip } from '../status/schema.js';
+const MAX_LIMIT = 20;
+/** A section is the answer itself, so it gets more room than a message. */
+const MAX_SECTION = 500;
+async function isFile(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function limitOf(value) {
+    const limit = Number(value ?? '3');
+    if (!Number.isInteger(limit) || limit < 1 || limit > MAX_LIMIT) {
+        throw new UsageError(`--limit takes 1 to ${MAX_LIMIT}`);
+    }
+    return limit;
+}
+function entryText(entry) {
+    const lines = [`#${entry.number} ${entry.title} (merged ${entry.merged?.slice(0, 10) ?? '?'})`];
+    for (const section of SECTIONS) {
+        const text = entry[section];
+        if (text !== null)
+            lines.push(`  ${section}:`, ...text.split('\n').map((l) => `    ${l}`));
+    }
+    if (SECTIONS.every((section) => entry[section] === null)) {
+        lines.push('  (no Problem, Discussion or Solution section)');
+        if (entry.summary !== null)
+            lines.push(...entry.summary.split('\n').map((l) => `    ${l}`));
+    }
+    return lines.join('\n');
+}
+function compact(entry) {
+    return {
+        number: entry.number,
+        title: clip(entry.title, 200),
+        merged: entry.merged,
+        problem: entry.problem === null ? null : clip(entry.problem, MAX_SECTION),
+        discussion: entry.discussion === null ? null : clip(entry.discussion, MAX_SECTION),
+        solution: entry.solution === null ? null : clip(entry.solution, MAX_SECTION),
+        summary: entry.summary === null ? null : clip(entry.summary, MAX_SECTION),
+    };
+}
+/**
+ * `talos why <path> [--limit N] [--repo owner/name] [--json]`: the merged PRs that last changed a
+ * path, with each one's Problem, Discussion and Solution, from `git log` and the API.
+ */
+export const why = async (argv, io) => {
+    const { values, positionals } = parse(argv, {
+        limit: { type: 'string' },
+        repo: { type: 'string' },
+        json: { type: 'boolean', default: false },
+    }, true);
+    const [target] = positionals;
+    if (target === undefined || positionals.length > 1)
+        throw new UsageError('give one path');
+    if (values.repo !== undefined && !isRepoName(values.repo)) {
+        throw new UsageError(`--repo takes owner/name, not "${values.repo}"`);
+    }
+    const limit = limitOf(values.limit);
+    const absolute = isAbsolute(target) ? target : join(io.cwd, target);
+    const path = relative(io.cwd, absolute).split(sep).join('/') || '.';
+    const repo = values.repo ?? (await currentRepository(io.env, io.cwd, exec));
+    if (repo === undefined)
+        throw new UsageError('no GitHub repository here: pass --repo owner/name');
+    const clone = git(exec, io.cwd);
+    const commits = await commitsFor(clone, path, await isFile(absolute));
+    const gh = github(await tokenFromEnvironment(io.env));
+    const entries = await whyFor({ gh, repo, limit }, commits);
+    if (values.json) {
+        const result = {
+            schema: 'talos.why/1',
+            repo,
+            path,
+            commits: commits.length,
+            prs: entries.map(compact),
+        };
+        io.out(`${JSON.stringify(result)}\n`);
+    }
+    else {
+        io.out(entries.length === 0
+            ? `no merged PR changed ${path}\n`
+            : `${entries.map(entryText).join('\n\n')}\n`);
+    }
+    return 0;
+};
+//# sourceMappingURL=why.js.map

package/dist/cli/why.js.map

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