tinybeeai 0.0.0-stage → 0.16.1

package/dist/true/sync-runs.js

@@ -0,0 +1,109 @@
+// Sends one finished dot run to True Platform as an automated run (KAT-406): replay the report into the Katalon reporter (src/true/replay.ts),
+// then the reporter's own upload sequence from the server: a login, signed URLs per suite, a PUT per file, and an end report per
+// suite. The execution uuid is a uuid v5 of the dot run id, so a resend writes the same files under the same execution. Each suite
+// reaches `uploaded` and then `reported`; a resend skips reported suites and repeats only the end report of uploaded ones.
+import { readFileSync } from 'node:fs';
+import { extname } from 'node:path';
+import { get, list, update } from '../db.js';
+import { TrueError } from './client.js';
+import { trueClock } from './clock.js';
+import { uuidV5 } from './names.js';
+import { replayReport } from './replay.js';
+import { GiveUpError } from './worker.js';
+const CONTENT_TYPES = {
+    '.log': 'text/xml',
+    '.xml': 'text/xml',
+    '.json': 'application/json',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.mov': 'video/quicktime',
+    '.txt': 'text/plain',
+};
+export const contentTypeOf = (file) => CONTENT_TYPES[extname(file).toLowerCase()] ?? 'application/octet-stream';
+/** U3: a PUT with 3 tries and 1 s and 2 s waits. A 4xx answer is final. */
+async function putWithRetry(ctx, url, data, type) {
+    const waits = [1000, 2000];
+    for (let i = 0;; i++) {
+        try {
+            await ctx.client.put(url, data, type);
+            return;
+        }
+        catch (err) {
+            if (!(err instanceof TrueError) || !err.retryable || i >= waits.length)
+                throw err;
+            await trueClock.sleep(waits[i]);
+        }
+    }
+}
+function saveUpload(runId, upload) {
+    update('runs', runId, { trueUpload: upload });
+}
+/** The page of the True run, or the project's Executions page when the run cannot be found by its uuid yet. */
+export function executionsUrl(tenantUrl, projectId, executionId) {
+    const base = `${tenantUrl.replace(/\/+$/, '')}/project/${projectId}/executions`;
+    return executionId ? `${base}/${executionId}/overview` : base;
+}
+/** The `automated_run` handler of the worker. */
+export async function syncAutomatedRun(ctx) {
+    const run = get('runs', ctx.item.refId);
+    const report = run?.report;
+    if (!run || !report || report.notRun || !report.cases?.length)
+        return;
+    const upload = run.trueUpload ?? { executionUuid: uuidV5(run.id), suites: {} };
+    if (!run.trueUpload)
+        saveUpload(run.id, upload);
+    const cases = list('test_cases', { dotId: run.watchId });
+    let replay;
+    try {
+        replay = await replayReport(run.id, report, cases);
+    }
+    catch (err) {
+        // The reporter did not write what it should: a bug or a changed reporter, not something to retry.
+        throw new GiveUpError(`localdost could not make the Katalon logs of this run: ${err instanceof Error ? err.message : String(err)}`, 'replay');
+    }
+    try {
+        for (const suite of replay.suites) {
+            if (upload.suites[suite.suiteUuid] === 'reported')
+                continue;
+            if (upload.suites[suite.suiteUuid] !== 'uploaded') {
+                const paths = suite.files.map((f) => `${suite.suiteUuid}/${f.rel}`);
+                const urls = await ctx.api.executionUrls(ctx.sync.projectId, upload.executionUuid, paths);
+                for (const f of suite.files) {
+                    const path = `${suite.suiteUuid}/${f.rel}`;
+                    const url = urls.get(path);
+                    if (!url)
+                        throw new TrueError(`True Platform gave no upload address for ${f.rel}.`, { kind: 'shape', retryable: true });
+                    await putWithRetry(ctx, url, readFileSync(f.abs), contentTypeOf(f.rel));
+                }
+                upload.suites[suite.suiteUuid] = 'uploaded';
+                saveUpload(run.id, upload);
+            }
+            const outputs = suite.files.map((f) => {
+                const parts = `${suite.suiteUuid}/${f.rel}`.split('/');
+                return { fileName: parts[parts.length - 1], path: parts.slice(0, -1).join('/') };
+            });
+            await ctx.api.reportEnd(ctx.sync.projectId, upload.executionUuid, suite.suiteUuid, outputs);
+            upload.suites[suite.suiteUuid] = 'reported';
+            saveUpload(run.id, upload);
+        }
+    }
+    finally {
+        replay.cleanup();
+    }
+    // U5: the run page links to the True run. The list field that carries the uuid is not known, so a miss is not an error.
+    let executionId;
+    try {
+        executionId = await ctx.api.findRunByUuid(upload.executionUuid);
+    }
+    catch (err) {
+        if (err instanceof TrueError && (err.hold || err.retryable))
+            throw err;
+    }
+    saveUpload(run.id, { ...upload, ...(executionId ? { executionId } : {}), url: executionsUrl(ctx.sync.tenantUrl, ctx.sync.projectId, executionId) });
+}
+//# sourceMappingURL=sync-runs.js.map

package/dist/true/sync-runs.js.map

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

package/dist/true/worker.js

@@ -0,0 +1,414 @@
+// The worker of the True Platform outbox (KAT-406). It ticks every 2 seconds, runs one item at a time per dot and up to 3 dots at once,
+// and applies the rules of docs/SETUP.md, section True Platform: retryable errors back off (1 min, 5 min, 15 min, 1 h, then every hour), 401 and 403
+// hold the dot, a dot that gets no answer for 5 minutes is held as unreachable and probed every 15 minutes, every other 4xx gives the
+// item up at once, and an item gives up after 24 hours of failing, not counting the time the dot was held. A send error changes
+// only the outbox item: it never reaches the localdost run, case or test run that the item is about.
+import { get, list, update } from '../db.js';
+import { TrueApi } from './api.js';
+import { TrueClient, TrueError } from './client.js';
+import { trueClock } from './clock.js';
+import { readTrueKey } from './key.js';
+import { maskTrue, trueLog } from './mask.js';
+import { ageMs, bankHeldTime, dotsWithWork, enqueue, GIVE_UP_MS, giveUp, getItem, iso, itemsOf, labelOf, liveItem, LEASE_MS, markDone, offline, patchItem, pruneDone, readiness, syncOn, TABLE, } from './outbox.js';
+/** A failure of the item that retrying does not fix. The text goes to the person as written. */
+export class GiveUpError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'GiveUpError';
+    }
+}
+const handlers = new Map();
+export function registerHandler(kind, fn) {
+    handlers.set(kind, fn);
+}
+// ---------- timing ----------
+const BACKOFF_MS = [60_000, 5 * 60_000, 15 * 60_000, 60 * 60_000];
+export const backoffMs = (attempts) => BACKOFF_MS[Math.min(Math.max(attempts, 1), BACKOFF_MS.length) - 1];
+const OUTAGE_AFTER_MS = 5 * 60_000;
+const PROBE_UNREACHABLE_MS = 15 * 60_000;
+const PROBE_REJECTED_MS = 60 * 60_000;
+const RECHECK_EVERY_MS = 24 * 60 * 60_000;
+const RECHECK_FOR_MS = 30 * 24 * 60 * 60_000;
+const MAX_DOTS_AT_ONCE = 3;
+/** The first failure of the dot with no answer since, per dot. A restart forgets it, which only delays a hold. */
+const streak = new Map();
+const probeAt = new Map();
+const stampAtHold = new Map();
+const lastRecheck = new Map();
+let lastRecheckScan = 0;
+function observer(dotId) {
+    return (answered) => {
+        if (answered)
+            streak.delete(dotId);
+        else if (!streak.has(dotId))
+            streak.set(dotId, trueClock.now());
+    };
+}
+/** Tests: forget the in-memory state of the worker. */
+export function resetWorkerState() {
+    streak.clear();
+    probeAt.clear();
+    stampAtHold.clear();
+    lastRecheck.clear();
+    lastRecheckScan = 0;
+}
+// ---------- the dot's sync state ----------
+function load(dotId) {
+    return get('watches', dotId);
+}
+function saveSync(dotId, patch) {
+    const w = load(dotId);
+    const cur = w?.trueSync;
+    if (!w || !cur)
+        throw new Error('This dot has no True Platform settings.');
+    const next = { ...cur, ...patch };
+    if (patch.blocked === null)
+        delete next.blocked;
+    update('watches', dotId, { trueSync: next });
+    return next;
+}
+/** When the next probe of a held dot runs (ms since the epoch), or undefined when it is not held. */
+export function nextProbeAt(dotId) {
+    return probeAt.get(dotId);
+}
+export const probeIntervalMs = (reason) => (reason === 'unreachable' ? PROBE_UNREACHABLE_MS : PROBE_REJECTED_MS);
+/** Holds every item of the dot. Held time does not count toward an item's 24 hours. */
+export function blockDot(w, reason) {
+    const cur = w.trueSync?.blocked;
+    if (cur?.reason === reason)
+        return;
+    if (cur)
+        bankHeldTime(w.id, Date.parse(cur.since));
+    saveSync(w.id, { blocked: { reason, since: iso() } });
+    probeAt.set(w.id, trueClock.now() + probeIntervalMs(reason));
+    stampAtHold.set(w.id, readTrueKey().stamp);
+    trueLog.warn(`${w.name}: sends are held (${reason})`);
+}
+export function unblockDot(w) {
+    const b = w.trueSync?.blocked;
+    if (!b)
+        return;
+    bankHeldTime(w.id, Date.parse(b.since));
+    saveSync(w.id, { blocked: null });
+    streak.delete(w.id);
+    probeAt.delete(w.id);
+    stampAtHold.delete(w.id);
+    trueLog.info(`${w.name}: sends resume`);
+}
+const targetOf = (w) => ({ tenantUrl: w.trueSync.tenantUrl, projectId: w.trueSync.projectId });
+/** One cheap call (L2). It answers a hold: success lifts it. */
+async function probe(w) {
+    const api = new TrueApi(new TrueClient(targetOf(w), observer(w.id)));
+    await api.repository();
+}
+/**
+ * True when the dot may send now. A dot without a key is held as key_missing and goes on at once when a key shows up. A held dot is
+ * probed on its schedule, or at once when the key changed (401 or 403).
+ */
+async function usable(w) {
+    const key = readTrueKey();
+    const b = w.trueSync?.blocked;
+    if (!key.key) {
+        if (b?.reason !== 'key_missing')
+            blockDot(w, 'key_missing');
+        return false;
+    }
+    if (!b)
+        return true;
+    if (b.reason === 'key_missing') {
+        unblockDot(w);
+        return true;
+    }
+    const changed = b.reason === 'key_rejected' && stampAtHold.get(w.id) !== undefined && stampAtHold.get(w.id) !== key.stamp;
+    const due = probeAt.get(w.id) ?? 0;
+    if (!changed && trueClock.now() < due)
+        return false;
+    try {
+        await probe(w);
+        unblockDot(w);
+        return true;
+    }
+    catch (err) {
+        probeAt.set(w.id, trueClock.now() + probeIntervalMs(b.reason));
+        stampAtHold.set(w.id, key.stamp);
+        // A different answer changes the reason: a key that works now but names no project is project_not_found.
+        if (err instanceof TrueError && err.hold && err.hold !== b.reason)
+            blockDot(w, err.hold);
+        return false;
+    }
+}
+// ---------- picking and running ----------
+function recoverLeases(dotId) {
+    const now = trueClock.now();
+    for (const it of itemsOf(dotId, { status: 'running' })) {
+        if (!it.leaseUntil || Date.parse(it.leaseUntil) <= now)
+            patchItem(it.id, { status: 'queued', leaseUntil: null, nextAt: iso(now) });
+    }
+}
+function holdOrRelease(dotId) {
+    const rows = list(TABLE, { dotId, status: offline() ? 'queued' : 'held' });
+    for (const it of rows) {
+        if (offline())
+            patchItem(it.id, { status: 'held', lastError: 'Not sent: sandbox mode.', lastErrorCode: 'sandbox' });
+        else if (it.lastErrorCode === 'sandbox')
+            patchItem(it.id, { status: 'queued', lastError: null, lastErrorCode: null, nextAt: iso() });
+    }
+}
+function pickDue(dotId) {
+    const now = trueClock.now();
+    for (const it of itemsOf(dotId, { status: 'queued' })) {
+        if (Date.parse(it.nextAt) > now)
+            continue;
+        const r = readiness(it);
+        if (r.state === 'dead') {
+            giveUp(it, `Not sent because ${labelOf(r.because)} was not sent.`, 'dependency');
+            continue;
+        }
+        if (r.state === 'wait')
+            continue;
+        if (!it.readyAt) {
+            patchItem(it.id, { readyAt: iso(now) });
+            return getItem(it.id);
+        }
+        return it;
+    }
+    return undefined;
+}
+async function runItem(w, picked) {
+    const handler = handlers.get(picked.kind);
+    if (!handler) {
+        giveUp(picked, 'localdost has no way to send this kind of item yet.');
+        return;
+    }
+    patchItem(picked.id, { status: 'running', attempts: picked.attempts + 1, leaseUntil: iso(trueClock.now() + LEASE_MS) });
+    const item = getItem(picked.id);
+    const client = new TrueClient(targetOf(w), observer(w.id));
+    const ctx = {
+        item,
+        dot: w,
+        sync: w.trueSync,
+        client,
+        api: new TrueApi(client),
+        saveSync: (patch) => {
+            const next = saveSync(w.id, patch);
+            ctx.sync = next;
+            return next;
+        },
+    };
+    // A long item keeps its lease: a restart takes it back only when this timer stopped.
+    const renew = setInterval(() => patchItem(item.id, { leaseUntil: iso(trueClock.now() + LEASE_MS) }), LEASE_MS / 3);
+    renew.unref?.();
+    try {
+        const out = await handler(ctx);
+        if (out === 'deferred')
+            return;
+        const fresh = getItem(item.id);
+        if (fresh && fresh.status === 'running')
+            markDone(fresh);
+    }
+    catch (err) {
+        onFailure(load(w.id) ?? w, item, err);
+    }
+    finally {
+        clearInterval(renew);
+    }
+}
+function onFailure(w, item, err) {
+    const fresh = getItem(item.id) ?? item;
+    const at = trueClock.now();
+    if (err instanceof GiveUpError) {
+        giveUp(fresh, err.message, err.code);
+        return;
+    }
+    if (!(err instanceof TrueError)) {
+        trueLog.error(`${labelOf(item)}: ${err instanceof Error ? (err.stack ?? err.message) : String(err)}`);
+        giveUp(fresh, `localdost could not send this: ${err instanceof Error ? err.message : String(err)}`, 'bug');
+        return;
+    }
+    if (err.hold) {
+        // The dot is held and the item waits as it was: no attempt counted, nothing lost.
+        patchItem(item.id, { status: 'queued', attempts: Math.max(0, fresh.attempts - 1), nextAt: iso(at), leaseUntil: null, lastError: err.message });
+        blockDot(w, err.hold);
+        return;
+    }
+    if (err.retryable) {
+        if (ageMs(fresh, w, at) >= GIVE_UP_MS) {
+            giveUp(fresh, `${err.message} localdost tried for 24 hours.`, 'gave_up_24h');
+            return;
+        }
+        const delay = Math.max(backoffMs(fresh.attempts), err.retryAfterMs ?? 0);
+        patchItem(item.id, { status: 'queued', nextAt: iso(at + delay), leaseUntil: null, lastError: err.message, lastErrorCode: 'retry' });
+        const since = streak.get(w.id);
+        if (since !== undefined && at - since >= OUTAGE_AFTER_MS)
+            blockDot(w, 'unreachable');
+        return;
+    }
+    giveUp(fresh, err.message, err.code ? `http_${err.code}` : undefined);
+}
+// ---------- the ticket recheck ----------
+/** Once a day: a `case` item for every case with a ticket that True did not have yet, for the first 30 days. */
+function recheckRequirements(w) {
+    const now = trueClock.now();
+    if (now - (lastRecheck.get(w.id) ?? 0) < RECHECK_EVERY_MS)
+        return;
+    lastRecheck.set(w.id, now);
+    for (const c of list('test_cases', { dotId: w.id })) {
+        const missing = Object.values(c.trueRequirements ?? {}).some((r) => r.id === null && r.firstMissingAt && now - Date.parse(r.firstMissingAt) < RECHECK_FOR_MS);
+        if (missing)
+            enqueueRecheck(w.id, c.id);
+    }
+}
+function enqueueRecheck(dotId, caseId) {
+    // An item already waiting for this case sends it whole, tickets included: the check adds nothing.
+    if (liveItem(dotId, `case:${caseId}`))
+        return;
+    enqueue(dotId, 'case', caseId, { payload: { recheck: true } });
+}
+/** Looks at every dot that sends to True at most once an hour; each dot is rechecked once a day. */
+function recheckAll() {
+    const now = trueClock.now();
+    if (now - lastRecheckScan < 60 * 60_000)
+        return;
+    lastRecheckScan = now;
+    for (const w of list('watches'))
+        if (syncOn(w))
+            recheckRequirements(w);
+}
+// ---------- ticks ----------
+async function tickDot(dotId) {
+    const w = load(dotId);
+    if (!w || !syncOn(w))
+        return 0;
+    recoverLeases(dotId);
+    holdOrRelease(dotId);
+    if (offline())
+        return 0;
+    if (!(await usable(w)))
+        return 0;
+    const due = pickDue(dotId);
+    if (!due)
+        return 0;
+    await runItem(load(dotId) ?? w, due);
+    return 1;
+}
+/** One pass over every dot with work. Returns how many items ran. */
+export async function tickOnce() {
+    try {
+        recheckAll();
+    }
+    catch (err) {
+        trueLog.error(`ticket recheck failed: ${maskTrue(err instanceof Error ? err.message : String(err))}`);
+    }
+    const dots = dotsWithWork();
+    let ran = 0;
+    const lanes = Array.from({ length: Math.min(MAX_DOTS_AT_ONCE, dots.length) }, async () => {
+        for (let id = dots.shift(); id !== undefined; id = dots.shift()) {
+            try {
+                ran += await tickDot(id);
+            }
+            catch (err) {
+                trueLog.error(`worker pass failed: ${maskTrue(err instanceof Error ? err.message : String(err))}`);
+            }
+        }
+    });
+    await Promise.all(lanes);
+    return ran;
+}
+/**
+ * When the worker next has something to do: the earliest due time of a queued item or a probe of a held dot, in milliseconds
+ * from the clock's now (0 when something is due now). Undefined when nothing waits. Tests move a virtual clock to it.
+ */
+export function nextWakeMs() {
+    const now = trueClock.now();
+    let best;
+    const take = (at) => {
+        const d = Math.max(0, at - now);
+        if (best === undefined || d < best)
+            best = d;
+    };
+    for (const dotId of dotsWithWork()) {
+        const w = load(dotId);
+        if (!w || !syncOn(w))
+            continue;
+        const blocked = w.trueSync?.blocked;
+        if (blocked) {
+            if (blocked.reason === 'key_missing')
+                take(now);
+            else
+                take(probeAt.get(dotId) ?? now);
+            continue;
+        }
+        for (const it of itemsOf(dotId, { status: 'queued' })) {
+            if (readiness(it).state === 'wait')
+                continue;
+            take(Date.parse(it.nextAt));
+        }
+        for (const it of itemsOf(dotId, { status: 'running' }))
+            take(it.leaseUntil ? Date.parse(it.leaseUntil) : now);
+    }
+    return best;
+}
+let timer;
+let ticking = false;
+let lastPrune = 0;
+/** Starts the 2-second tick. Returns the function that stops it. */
+export function startTrueWorker() {
+    if (timer)
+        return () => stopTrueWorker();
+    timer = setInterval(() => {
+        if (ticking)
+            return;
+        ticking = true;
+        void tickOnce()
+            .then(() => {
+            if (trueClock.now() - lastPrune > 60 * 60_000) {
+                lastPrune = trueClock.now();
+                pruneDone();
+            }
+        })
+            .catch((err) => trueLog.error(`worker tick failed: ${err instanceof Error ? err.message : String(err)}`))
+            .finally(() => {
+            ticking = false;
+        });
+    }, 2000);
+    timer.unref?.();
+    return () => stopTrueWorker();
+}
+export function stopTrueWorker() {
+    if (timer)
+        clearInterval(timer);
+    timer = undefined;
+}
+/**
+ * Tests and the "send now" paths: ticks until nothing is due. With the virtual clock on and `advance`, it moves the clock to the next
+ * due time when nothing is due now, so backoff, probes and a 30-hour outage run in milliseconds. Stops after `maxTicks`.
+ */
+export async function drainTrue(o = {}) {
+    const max = o.maxTicks ?? 5000;
+    let total = 0;
+    for (let i = 0; i < max; i++) {
+        const ran = await tickOnce();
+        total += ran;
+        if (ran > 0)
+            continue;
+        const wake = nextWakeMs();
+        if (wake === undefined)
+            return total;
+        if (wake > 0) {
+            if (!o.advance || !trueClock.isVirtual)
+                return total;
+            trueClock.advance(wake);
+        }
+        else if (i > 50 && ran === 0) {
+            // Something is due but cannot run (a dot that stays held with a probe due each pass): let time pass.
+            if (o.advance && trueClock.isVirtual)
+                trueClock.advance(1000);
+            else
+                return total;
+        }
+    }
+    return total;
+}
+//# sourceMappingURL=worker.js.map

package/dist/true/worker.js.map

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

package/dist/types.js

@@ -0,0 +1,32 @@
+// Shared contract for every track. Add fields only; never rename or change a shape.
+export const DEFAULT_RULES = {
+    run_tests: 'act',
+    check_run: 'act',
+    pr_comment: 'act',
+    ticket_comment: 'ask',
+    push_notify: 'act',
+    open_pr: 'act_when_asked',
+    revert: 'hand_off',
+    mcp_tool: 'ask',
+    slack_post: 'act',
+    report_edit: 'ask',
+    // A bug the dot found becomes a defect in the dot's tracker (KAT-96). A person approves each one.
+    file_defect: 'ask',
+    // A defect drafted from a test that failed on both retries (KAT-87). A person approves each one.
+    issue_create: 'ask',
+    // Retiring a test case the ticket made obsolete (KAT-304). It always asks: the gate never lets this kind run on its own.
+    case_retire: 'ask',
+    // Moving a ticket to another status from a card (KAT-136). A person asked for it, and a person approves it by default.
+    ticket_status: 'ask',
+};
+/** What the strip says for a dot with no repository and no ticket tracker that never checked anything. The panel and the dot list say it in these words. */
+export const NO_CHECK_YET = 'No checks yet. The first one starts when a PR or a ticket comes in.';
+/** A dot with a QA site that never checked anything, where site checks run: the site check is the first one it makes. */
+export const NO_CHECK_SITE = 'No checks yet. The first site check runs within a minute.';
+/** The reason of a dot with no repository, no ticket tracker and no QA site: nothing can start a check, so the sentence says what is missing. */
+export const NOTHING_TO_WATCH = 'Nothing to watch yet. There is no repository, ticket tracker or QA site.';
+/** A dot whose only source is a QA site, with the Prod watcher off: no site check runs, so nothing can come in. */
+export const SITE_CHECKS_OFF = 'Turn on site checks to start watching this site.';
+/** A dot whose only source is a QA site, on a server in sandbox mode: no site check runs there. */
+export const SITE_CHECKS_SANDBOX = 'Site checks do not run in sandbox mode.';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAuBpF,MAAM,CAAC,MAAM,aAAa,GAAkC;IAC1D,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,KAAK;IAChB,UAAU,EAAE,KAAK;IACjB,cAAc,EAAE,KAAK;IACrB,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,UAAU;IAClB,QAAQ,EAAE,KAAK;IACf,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,KAAK;IAClB,kGAAkG;IAClG,WAAW,EAAE,KAAK;IAClB,iGAAiG;IACjG,YAAY,EAAE,KAAK;IACnB,yHAAyH;IACzH,WAAW,EAAE,KAAK;IAClB,uHAAuH;IACvH,aAAa,EAAE,KAAK;CACrB,CAAC;AAykHF,4JAA4J;AAC5J,MAAM,CAAC,MAAM,YAAY,GAAG,qEAAqE,CAAC;AAElG,yHAAyH;AACzH,MAAM,CAAC,MAAM,aAAa,GAAG,2DAA2D,CAAC;AAEzF,iJAAiJ;AACjJ,MAAM,CAAC,MAAM,gBAAgB,GAAG,0EAA0E,CAAC;AAS3G,mHAAmH;AACnH,MAAM,CAAC,MAAM,eAAe,GAAG,kDAAkD,CAAC;AAElF,mGAAmG;AACnG,MAAM,CAAC,MAAM,mBAAmB,GAAG,yCAAyC,CAAC"}

package/dist/updates/asks.js

@@ -0,0 +1,38 @@
+// Who asked for a piece of work. A chat or Slack turn that queues a job (rerun_tests, review_pr,
+// review_ticket) or opens a run records the place it was asked, so the result replies in that thread.
+import { findOne, get, insert } from '../db.js';
+import { liveJobId } from '../ticket-supersede.js';
+export function recordAsk(a) {
+    if (!a.jobId && !a.runId)
+        return;
+    try {
+        if (a.jobId && findOne('asks', { jobId: a.jobId }))
+            return;
+        if (a.runId && findOne('asks', { runId: a.runId }))
+            return;
+        insert('asks', { watchId: a.watchId, origin: a.origin, ...(a.jobId ? { jobId: a.jobId } : {}), ...(a.runId ? { runId: a.runId } : {}) });
+    }
+    catch (err) {
+        console.warn('[updates] could not record who asked', err);
+    }
+}
+/** Records the ask for a queued job; the job row names the dot. A review a newer edit already replaced records its ask on the live job. */
+export function recordAskForJob(jobId, origin) {
+    const live = liveJobId(jobId);
+    const job = get('jobs', live);
+    if (job)
+        recordAsk({ watchId: job.watchId, jobId: live, origin });
+}
+/** Where the work behind a run was asked for, or undefined when nobody asked. */
+export function askForRun(run) {
+    const byRun = findOne('asks', { runId: run.id });
+    if (byRun)
+        return byRun.origin;
+    if (run.jobId)
+        return findOne('asks', { jobId: run.jobId })?.origin;
+    return undefined;
+}
+export function askForJob(jobId) {
+    return findOne('asks', { jobId })?.origin;
+}
+//# sourceMappingURL=asks.js.map

package/dist/updates/asks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asks.js","sourceRoot":"","sources":["../../src/updates/asks.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,sGAAsG;AACtG,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAWnD,MAAM,UAAU,SAAS,CAAC,CAAyE;IACjG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK;QAAE,OAAO;IACjC,IAAI,CAAC;QACH,IAAI,CAAC,CAAC,KAAK,IAAI,OAAO,CAAS,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAAE,OAAO;QACnE,IAAI,CAAC,CAAC,KAAK,IAAI,OAAO,CAAS,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAAE,OAAO;QACnE,MAAM,CAAS,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACnJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,2IAA2I;AAC3I,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,MAAiB;IAC9D,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,GAAG,CAAM,MAAM,EAAE,IAAI,CAAC,CAAC;IACnC,IAAI,GAAG;QAAE,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,SAAS,CAAC,GAAgD;IACxE,MAAM,KAAK,GAAG,OAAO,CAAS,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IACzD,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC/B,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO,OAAO,CAAS,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC;IAC5E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,OAAO,CAAS,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC;AACpD,CAAC"}