tinybeeai 0.0.0-stage → 0.16.1

package/dist/flows/mergeCases.js

@@ -0,0 +1,169 @@
+// KAT-169: after a merge, the regression runner works the cases of the tickets the merge closes or references.
+// Automated cases (with a spec) get their result through the dot run's automated test run (linkRunResults). Manual
+// cases cannot run, so they become run items of one manual test run for that merge, to work by hand. Retired cases
+// are skipped. A defect drafted from the run names the case its failing test maps to.
+import { addStep } from '../agent/runs.js';
+import { ensureVersion, getCase, ownsSpec } from '../cases.js';
+import { config } from '../config.js';
+import { get, insert, list, update } from '../db.js';
+import { issueRef } from '../integrations/github-issues.js';
+import { teamIds } from '../lead.js';
+import { linksFor } from '../links.js';
+import { linkRunResults } from '../test-runs.js';
+import { casesForTicket, firstPerKey } from './testDesign.js';
+const now = () => new Date().toISOString();
+const plural = (n, one) => `${n} ${one}${n === 1 ? '' : 's'}`;
+const keyNum = (c) => Number(c.key.slice(3)) || 0;
+/**
+ * Tickets the merge's PR closes or references, as link refs. A dot in a team also reads the links its members recorded for the PR, so
+ * Regression Runner finds the ticket PR Reviewer linked (KAT-405).
+ */
+function ticketsOf(watch, ev) {
+    if (!ev.pr || !ev.repo)
+        return [];
+    const pr = issueRef(`${ev.repo.owner}/${ev.repo.name}`, ev.pr.number);
+    const out = new Set();
+    for (const id of teamIds(watch.id))
+        for (const l of linksFor(pr, id))
+            if (l.fromRef === pr && (l.kind === 'closes' || l.kind === 'references'))
+                out.add(l.toRef);
+    return [...out];
+}
+/**
+ * Draft and ready cases of the tickets, each once. A retired case is never run. A dot in a team runs the cases of every member for the
+ * ticket (Ticket Reviewer designed them), its own first, and a key the team holds twice runs once, the first case winning (KAT-405).
+ */
+export function activeCasesOf(watch, tickets) {
+    const seen = new Map();
+    // The asking dot's cases come first, so a key two members hold maps to its own case.
+    const ids = [watch.id, ...teamIds(watch.id).filter((id) => id !== watch.id)];
+    for (const t of tickets)
+        for (const c of casesForTicket(ids, t))
+            if (c.status !== 'retired')
+                seen.set(c.id, c);
+    return firstPerKey([...seen.values()].sort((a, b) => ids.indexOf(a.dotId) - ids.indexOf(b.dotId) || keyNum(a) - keyNum(b))).sort((a, b) => ids.indexOf(a.dotId) - ids.indexOf(b.dotId) || keyNum(a) - keyNum(b));
+}
+function titleOf(ev) {
+    const t = ev.title.replace(/^Merged\s+/i, '').trim() || 'merge';
+    return `After merge: ${t}`.slice(0, 200);
+}
+/** The manual test run of this merge, made when missing. A second post_merge of the same merge finds the first. */
+function mergeRun(watch, ev) {
+    const sha = (ev.pr?.mergeSha ?? ev.push?.after ?? '').toLowerCase();
+    const configKey = `merge:${ev.pr ? `${ev.repo?.owner}/${ev.repo?.name}#${ev.pr.number}`.toLowerCase() : sha}`;
+    const found = list('test_runs', { dotId: watch.id, source: 'manual', configKey }, { limit: 1 })[0];
+    if (found)
+        return found;
+    const at = now();
+    return insert('test_runs', {
+        dotId: watch.id,
+        name: titleOf(ev),
+        source: 'manual',
+        status: 'open',
+        configKey,
+        ...(/^[0-9a-f]{7,40}$/.test(sha) ? { buildSha: sha } : {}),
+        createdAt: at,
+        updatedAt: at,
+    });
+}
+/**
+ * Works the cases of a merge. Nothing happens when the merge names no ticket or the tickets have no active case.
+ * Never throws: a store error is a warning step and the run goes on.
+ */
+export function runMergeCases(watch, run, ev, report) {
+    const empty = { cases: [], recorded: 0, added: 0, waiting: 0 };
+    try {
+        const tickets = ticketsOf(watch, ev);
+        if (!tickets.length)
+            return empty;
+        const found = activeCasesOf(watch, tickets);
+        if (!found.length)
+            return empty;
+        const automated = found.filter((c) => c.specPath);
+        const manual = found.filter((c) => !c.specPath);
+        const res = {
+            cases: found.map((c) => ({
+                id: c.id,
+                key: c.key,
+                title: c.title,
+                ...(c.specPath ? { specPath: c.specPath } : {}),
+                ...(c.dotId !== watch.id ? { dotId: c.dotId, dotName: get('watches', c.dotId)?.name ?? 'another dot' } : {}),
+            })),
+            recorded: 0,
+            added: 0,
+            waiting: 0,
+        };
+        if (automated.length) {
+            // The existing results path: it updates the rows a first save wrote, so a repeat adds none.
+            linkRunResults(run, report);
+            const ids = new Set(list('case_results', { dotRunId: run.id }).map((r) => r.caseId));
+            res.recorded = automated.filter((c) => ids.has(c.id)).length;
+        }
+        if (manual.length) {
+            const t = mergeRun(watch, ev);
+            const items = list('run_items', { testRunId: t.id });
+            const have = new Set(items.map((i) => i.caseId));
+            let position = items.length;
+            const at = now();
+            for (const c of manual) {
+                if (have.has(c.id))
+                    continue;
+                insert('run_items', {
+                    testRunId: t.id,
+                    dotId: watch.id,
+                    caseId: c.id,
+                    caseVersion: ensureVersion(c),
+                    position: ++position,
+                    state: 'untested',
+                    attempt: 1,
+                    updatedAt: at,
+                    createdAt: at,
+                });
+                res.added++;
+            }
+            if (res.added && t.status === 'done')
+                update('test_runs', t.id, { status: 'in_progress', updatedAt: at });
+            else if (res.added)
+                update('test_runs', t.id, { updatedAt: at });
+            res.testRunId = t.id;
+            res.waiting = list('run_items', { testRunId: t.id }).filter((i) => i.state === 'untested' || i.state === 'retest').length;
+            addStep(run.id, 'Manual cases waiting', `${plural(res.waiting, 'manual case')} waiting in test run "${t.name}"${res.added ? ` (${res.added} new)` : ''}.`, 'info');
+        }
+        if (automated.length)
+            addStep(run.id, 'Ticket cases run', `${res.recorded} of ${plural(automated.length, 'automated case')} from the merge's tickets recorded a result.`, 'info');
+        return res;
+    }
+    catch (err) {
+        addStep(run.id, 'Ticket cases failed', String(err), 'warn');
+        return empty;
+    }
+}
+/** The merge case whose spec holds the failing test, or undefined. */
+export function caseForTest(cases, file) {
+    if (!cases?.length || !file)
+        return undefined;
+    const specs = cases.flatMap((c) => (c.specPath ? [c.specPath] : []));
+    return cases.find((c) => c.specPath && ownsSpec(c.specPath, file, specs));
+}
+/** The meta fields a defect carries for its case. */
+export function caseMeta(c) {
+    return c ? { caseId: c.id, caseKey: c.key } : {};
+}
+/** The defect body line that names the case. It links only with a public URL: a relative link would open the tracker (KAT-342). */
+export function caseLine(dotId, c) {
+    if (!c)
+        return '';
+    // The case page is under the dot that owns the case, and the line names that dot when it is not the one that ran the merge (KAT-405).
+    const owner = c.dotId ?? dotId;
+    const href = config.publicUrl ? `${config.publicUrl.replace(/\/$/, '')}/#/cases?${new URLSearchParams({ dot: owner, case: c.key }).toString()}` : undefined;
+    const by = c.dotName ? ` (${c.dotName})` : '';
+    return `Test case: ${href ? `[${c.key}](${href})` : c.key} ${c.title.replace(/[\r\n]+/g, ' ').slice(0, 120)}${by}`;
+}
+/** The case a defect names, for its body: the line, and the steps a person follows to reproduce it (KAT-377). */
+export function caseDetail(dotId, c) {
+    if (!c)
+        return undefined;
+    const steps = (getCase(c.id)?.steps ?? []).map((s) => s.action.replace(/\s+/g, ' ').trim()).filter(Boolean);
+    return { line: caseLine(dotId, c), steps };
+}
+//# sourceMappingURL=mergeCases.js.map

package/dist/flows/mergeCases.js.map

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

package/dist/flows/nightlyRun.js

@@ -0,0 +1,82 @@
+// nightly_run: the suite of the dot's Tests repo against the dot's Base URL, on a timer (KAT-390).
+//
+// The timer is src/nightly-scheduler.ts. This is the job it queues. It runs the Tests repo path of KAT-86 (src/flows/testRepo.ts): the
+// ref of the Tests repo is its default branch (or the fixed ref its settings name), the commit is checked out through the cache, and the
+// report names the specs `owner/name:path`. Every Tests repo of the dot runs, whatever its `on` and `targets` say, since nothing in a
+// timer names an app repo or a job. The run is a run like any other: it shows in Activity, counts in the morning digest, and a run that
+// fails pushes one alert.
+import { getLlmFor } from '../agent/llm.js';
+import { listMemory } from '../agent/memory.js';
+import { gate } from '../agent/rules.js';
+import { addStep, finishRun, isRunCancelled, setReport, setVerdict, startRun } from '../agent/runs.js';
+import { NIGHTLY_LATE_NOTE_MS } from '../nightly.js';
+import { nightlyBlocker } from '../nightly-scheduler.js';
+import { registerHandler } from '../queue.js';
+import { watchRepos } from '../repos.js';
+import { runStage } from '../stages/index.js';
+import { demoAppUrl, ensureDemoApp, eventOf, guarded, loadWatch, noteModelFallback, notRunVerdict, pushAction, withDemoShop } from './common.js';
+import { runTestRepos } from './testRepo.js';
+/** The verdict of a night that did not start: nothing ran, so nothing is claimed about the product. The dot shows it as needing a person. */
+export function notStartedVerdict(reason) {
+    return {
+        outcome: 'needs_attention',
+        headline: `The nightly test run did not start: ${reason.replace(/\.$/, '')}`,
+        summary: `### localdost: the nightly test run did not start\n${reason}\n\nNothing ran, so this says nothing about whether the app works. Fix it in the dot settings, then use Check again.`,
+        risk: 'low',
+        findings: [{ title: 'The nightly test run did not start', detail: reason, severity: 'medium' }],
+        openQuestions: [],
+        testIdeas: [],
+        testsAtRisk: [],
+        confidence: 0.95,
+    };
+}
+async function targetUrl(watch) {
+    if (watch.runner.mode !== 'demo')
+        return watch.baseUrl?.trim() || undefined;
+    try {
+        return await ensureDemoApp(watch);
+    }
+    catch {
+        return demoAppUrl(watch);
+    }
+}
+registerHandler('nightly_run', async (job) => {
+    const watch = loadWatch(job.watchId);
+    // A dot that was paused or archived after the slot was queued runs nothing, and no run row says it did.
+    if (watch.paused || watch.archived)
+        return;
+    const ev = eventOf(job);
+    const run = startRun(watch.id, 'nightly_run', ev);
+    await guarded(run.id, async () => {
+        const late = ev.nightly?.lateMs ?? 0;
+        if (late > NIGHTLY_LATE_NOTE_MS)
+            addStep(run.id, 'Started late', `The scheduled time was ${Math.round(late / 60_000)} minutes before this run started, because the server was down or busy.`, 'info');
+        const blocked = nightlyBlocker(watch);
+        if (blocked) {
+            addStep(run.id, 'The nightly test run cannot start', blocked, 'warn');
+            const stopped = notStartedVerdict(blocked);
+            setVerdict(run.id, stopped);
+            await gate(pushAction(stopped.headline, 'Nothing ran. Fix the dot settings, then check again.', 'normal', `nightly:${run.id}`), watch, run.id);
+            finishRun(run.id, 'done');
+            return;
+        }
+        const repos = watchRepos(watch).filter((r) => r.role === 'test');
+        const baseUrl = await targetUrl(watch);
+        addStep(run.id, 'Nightly test run', `${repos.map((r) => `${r.owner}/${r.name}`).join(', ')} against ${baseUrl ?? 'the Base URL'}.`, 'info');
+        const out = await withDemoShop(watch, () => runTestRepos({ watch, ev, runId: run.id, task: 'post_merge', ...(baseUrl ? { baseUrl } : {}), repos }));
+        if (!out || isRunCancelled(run.id))
+            return;
+        const { report } = out;
+        setReport(run.id, report);
+        const verdict = report.notRun && report.failed === 0
+            ? notRunVerdict(report, 'the app')
+            : noteModelFallback(run.id, await getLlmFor(watch, runStage(run)).analyze({ task: 'post_merge', watch, event: ev, report, memory: listMemory(watch.id) }));
+        setVerdict(run.id, verdict);
+        addStep(run.id, 'Verdict', verdict.headline, verdict.outcome === 'pass' ? 'ok' : 'warn');
+        // A pass is quiet: the morning digest lists it. A night that failed, or did not run, tells a person once.
+        if (verdict.outcome !== 'pass' && verdict.outcome !== 'info')
+            await gate(pushAction(verdict.headline, 'The nightly test run found a problem.', 'normal', `nightly:${run.id}`), watch, run.id);
+        finishRun(run.id, 'done');
+    });
+});
+//# sourceMappingURL=nightlyRun.js.map

package/dist/flows/nightlyRun.js.map

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

package/dist/flows/outage.js

@@ -0,0 +1,64 @@
+// outage: probe or status page failure. Blame the most recent merge when the timing fits, push urgently.
+import { getLlmFor } from '../agent/llm.js';
+import { runStage } from '../stages/index.js';
+import { listMemory } from '../agent/memory.js';
+import { gate } from '../agent/rules.js';
+import { addStep, finishRun, setVerdict, startRun } from '../agent/runs.js';
+import { registerHandler } from '../queue.js';
+import { postNotice } from '../slack/index.js';
+import { eventOf, guarded, loadWatch, pushAction, recentRuns, noteModelFallback } from './common.js';
+/**
+ * An outage of the dot itself (src/monitor/self-health.ts): a delivery channel that keeps failing, or test totals
+ * that never change. Fixed text, no model call, and no merge to blame; the headline names what is broken.
+ */
+async function selfOutage(watch, runId, s) {
+    addStep(runId, 'Self-health check failed', s.detail, 'error');
+    const delivery = s.check.startsWith('delivery:');
+    setVerdict(runId, {
+        outcome: 'needs_attention',
+        headline: s.title,
+        summary: [
+            `### ${s.title}`,
+            `- ${s.detail}`,
+            delivery
+                ? '- Alerts on this channel do not reach anyone until it is fixed. Check the channel in Setup and send a test.'
+                : '- The reports may show an old result. Check that the test command runs the current checkout.',
+        ].join('\n'),
+        risk: 'high',
+        findings: [{ title: s.title, detail: s.detail, severity: 'high' }],
+        openQuestions: [],
+        testIdeas: [],
+        testsAtRisk: [],
+        confidence: 0.9,
+    });
+    const key = `self:${watch.id}:${s.check}`;
+    await gate(pushAction(s.title, s.detail, 'high', key), watch, runId);
+    await postNotice(watch, { key, title: s.title, body: s.detail, url: `/#/runs/${runId}`, urgency: 'high' }, runId, { templated: true });
+    finishRun(runId, 'done', 'outage');
+}
+registerHandler('outage', async (job) => {
+    const watch = loadWatch(job.watchId);
+    if (watch.paused)
+        return;
+    const ev = eventOf(job);
+    const recent = recentRuns(watch.id, 24);
+    const run = startRun(watch.id, 'outage', ev);
+    await guarded(run.id, async () => {
+        if (ev.selfHealth)
+            return selfOutage(watch, run.id, ev.selfHealth);
+        const p = ev.probe;
+        addStep(run.id, ev.kind === 'statuspage' ? 'Status page degraded' : 'Probe failing', p ? `${p.url}: ${p.status ? `HTTP ${p.status}` : (p.error ?? 'no response')}, ${p.consecutiveFailures} checks in a row` : ev.title, 'error');
+        const merges = recent.filter((r) => r.kind === 'post_merge');
+        addStep(run.id, 'Checked recent merges', merges.length ? `${merges.length} in the last 24 h, latest "${merges[0].trigger?.title}"` : 'None in the last 24 h');
+        const verdict = noteModelFallback(run.id, await getLlmFor(watch, runStage(run)).analyze({ task: 'outage', watch, event: ev, recentRuns: recent, memory: listMemory(watch.id) }));
+        setVerdict(run.id, verdict);
+        if (verdict.suspectedCause)
+            addStep(run.id, 'Suspected cause', verdict.suspectedCause, 'warn');
+        const key = `outage:${watch.id}:${p?.url ?? ev.dedupeKey}`;
+        await gate(pushAction(verdict.headline, verdict.suspectedCause ?? 'Open the run for details.', 'high', key), watch, run.id);
+        // Also the dot's Slack channel, when it has one (gated as slack_post).
+        await postNotice(watch, { key, title: verdict.headline, body: verdict.suspectedCause ?? verdict.summary, url: `/#/runs/${run.id}`, urgency: 'high' }, run.id);
+        finishRun(run.id, 'done', 'outage');
+    });
+});
+//# sourceMappingURL=outage.js.map

package/dist/flows/outage.js.map

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

package/dist/flows/postMerge.js

@@ -0,0 +1,5 @@
+// post_merge: test the merged change, retry failures, judge, report through the gate.
+import { registerHandler } from '../queue.js';
+import { checkChange } from './change.js';
+registerHandler('post_merge', (job) => checkChange(job, 'post_merge'));
+//# sourceMappingURL=postMerge.js.map

package/dist/flows/postMerge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postMerge.js","sourceRoot":"","sources":["../../src/flows/postMerge.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,eAAe,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC"}

package/dist/flows/prCheck.js

@@ -0,0 +1,5 @@
+// pr_check: same as post_merge, against the preview URL when known, one sticky PR comment.
+import { registerHandler } from '../queue.js';
+import { checkChange } from './change.js';
+registerHandler('pr_check', (job) => checkChange(job, 'pr_check'));
+//# sourceMappingURL=prCheck.js.map

package/dist/flows/prCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prCheck.js","sourceRoot":"","sources":["../../src/flows/prCheck.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,eAAe,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC"}

package/dist/flows/prTarget.js

@@ -0,0 +1,66 @@
+export const PR_TEST_TARGETS = ['base', 'preview-only', 'none'];
+export function prTestTargetOf(w) {
+    return w.prTestTarget ?? 'base';
+}
+/** Why a dot's `prTestTarget` is not usable, or null. Used by the dot create and update routes. */
+export function prTestTargetError(v) {
+    if (v === undefined)
+        return null;
+    return PR_TEST_TARGETS.includes(v) ? null : `prTestTarget must be one of ${PR_TEST_TARGETS.join(', ')}.`;
+}
+/**
+ * True when the URL is a build that other work shares (a QA or staging site). A URL on this machine is the app the test
+ * project starts itself from the checkout of the PR (src/runner/index.ts, appServerVars), so it is the PR's own build.
+ */
+export function isSharedBuild(url) {
+    if (!url)
+        return false;
+    let host;
+    try {
+        host = new URL(url).hostname.replace(/^\[|\]$/g, '').toLowerCase();
+    }
+    catch {
+        return false;
+    }
+    return !(host === 'localhost' || host.endsWith('.localhost') || host === '::1' || host === '0.0.0.0' || /^127\./.test(host));
+}
+/**
+ * What a PR check does with its tests. `preview` is the URL of a deployment of this PR's head, when one is known. A demo
+ * dot tests the shop it builds from the PR, and a dot with no base URL, or one on this machine, tests the PR's own build.
+ */
+export function prTestPlan(o) {
+    const target = prTestTargetOf(o.watch);
+    if (target === 'none')
+        return { run: false, skip: 'this dot runs no tests on PRs' };
+    if (o.preview || o.watch.runner.mode === 'demo')
+        return { run: true };
+    if (target === 'preview-only')
+        return { run: false, skip: 'this dot tests PRs only against a preview of the PR, and this PR has none' };
+    return { run: true, shared: isSharedBuild(o.watch.baseUrl) };
+}
+/** The sentence a report carries when its tests ran against the shared build. With a failure it says what that may mean. */
+export function sharedBuildNote(failed) {
+    return `Tests ran against the shared QA build, not a build of this PR.${failed > 0 ? " A failure may be this PR's new or changed spec running against an older build, so no defect was drafted from it." : ''}`;
+}
+/**
+ * The verdict of a PR check whose failed tests ran against the shared build. The model saw a failing test and blamed the change,
+ * but a build that does not hold the PR cannot say so: the report keeps the failure as a risk to test, the check stays neutral
+ * and no product push goes out. A verdict that is already no product or test failure stays as it is.
+ */
+export function sharedBuildVerdict(v, report) {
+    if (report.notRun || report.failed === 0)
+        return v;
+    if (v.outcome !== 'product_failure' && v.outcome !== 'test_failure')
+        return v;
+    const n = report.failed;
+    const { suspectedCause: _blamed, ...rest } = v;
+    return {
+        ...rest,
+        outcome: 'needs_attention',
+        headline: `${n} test${n === 1 ? '' : 's'} failed against the shared QA build, not a build of this PR`,
+        summary: `### localdost: tests ran against the shared QA build\n${n} test${n === 1 ? '' : 's'} failed against a build without this PR's code, so localdost reports no bug from ${n === 1 ? 'it' : 'them'}. Run ${n === 1 ? 'it' : 'them'} on a build of this PR to confirm.`,
+        // The failure no longer says the change is risky.
+        risk: v.risk === 'high' ? 'medium' : v.risk,
+    };
+}
+//# sourceMappingURL=prTarget.js.map

package/dist/flows/prTarget.js.map

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