tinybeeai 0.0.0-stage → 0.16.1

package/dist/review/specs.js

@@ -0,0 +1,150 @@
+// Spec inventory: every test file in the checkout with its titles, visited routes,
+// test ids, text locators and imports, each with a line number, so a spec can be
+// linked to an impact area and a removed selector can be traced to the line that uses it.
+import { posix } from 'node:path';
+import { isTestFile } from './classify.js';
+import { extractImports } from './imports.js';
+export const MAX_SPECS = 2000;
+const SPEC_CODE = /\.(ts|tsx|js|jsx|mjs|cjs|py)$/;
+function lineAt(text, index) {
+    let n = 1;
+    for (let i = 0; i < index && i < text.length; i++)
+        if (text.charCodeAt(i) === 10)
+            n++;
+    return n;
+}
+function unq(s) {
+    return s.replace(/\\(['"`\\])/g, '$1');
+}
+/** Path part of a goto target: drops `${baseUrl}`, origins and query strings. */
+export function routeOfTarget(target) {
+    let t = target.trim();
+    t = t.replace(/^\$\{[^}]*\}/, '');
+    const abs = /^[a-z]+:\/\/[^/]+(\/.*)?$/i.exec(t);
+    if (abs)
+        t = abs[1] ?? '/';
+    if (!t.startsWith('/')) {
+        if (t === '' || t === '.')
+            return '/';
+        if (/^[\w-]+(\/|$)/.test(t))
+            t = `/${t}`;
+        else
+            return null;
+    }
+    t = t.split(/[?#]/)[0].replace(/\$\{[^}]*\}/g, ':param');
+    return t.length > 1 ? t.replace(/\/+$/, '') : t;
+}
+const STR = `(['"\`])((?:\\\\.|(?!\\1)[^\\n])*)\\1`;
+const TITLE_RE = new RegExp(`\\b(?:test|it|describe|context|suite|specify)(?:\\.(?:describe|only|skip|fixme|serial|parallel|step|concurrent|each\\([^)]*\\)))*\\s*\\(\\s*${STR}`, 'g');
+const GOTO_RE = new RegExp(`(?:\\.goto|cy\\.visit|\\bvisit|\\bnavigate(?:To)?)\\(\\s*${STR}`, 'g');
+const REQ_RE = new RegExp(`\\b(?:request|client|api|supertest\\([^)]*\\)|agent)\\.(?:get|post|put|patch|delete)\\(\\s*${STR}`, 'g');
+const TESTID_RE = new RegExp(`getByTestId\\(\\s*${STR}`, 'g');
+const ATTR_RE = /\[\s*data-(?:testid|test-id|test|cy|qa)\s*=\s*["']?([^"'\]\s]+)["']?\s*\]/g;
+const ROLE_NAME_RE = new RegExp(`getByRole\\([^)]*?\\bname:\\s*${STR}`, 'g');
+const TEXT_RE = new RegExp(`(?:getBy(?:Text|Label|Placeholder|AltText|Title)|findBy(?:Text|LabelText|PlaceholderText)|getBy(?:LabelText|PlaceholderText|DisplayValue)|toHaveText|toContainText|toHaveValue|cy\\.contains|has-text\\(|text=)\\(?\\s*${STR}`, 'g');
+/** Parses one spec file. Imports stay raw here; specInventory resolves them. */
+export function parseSpec(path, text, smokeGrep = '@smoke') {
+    const refs = [];
+    const titles = [];
+    const push = (kind, value, index) => {
+        const v = unq(value).trim();
+        if (!v || v.length > 200)
+            return;
+        refs.push({ kind, value: v, line: lineAt(text, index) });
+    };
+    if (path.endsWith('.py')) {
+        for (const m of text.matchAll(/^\s*(?:async\s+)?def\s+(test_\w+)/gm))
+            titles.push(m[1]);
+        for (const m of text.matchAll(/^\s*class\s+(Test\w+)/gm))
+            titles.push(m[1]);
+        for (const m of text.matchAll(/\b(?:client|page|self\.client)\.(?:get|post|put|patch|delete|goto)\(\s*f?(['"])([^'"]*)\1/g)) {
+            const r = routeOfTarget(m[2]);
+            if (r)
+                push('route', r, m.index ?? 0);
+        }
+        for (const m of text.matchAll(/get_by_test_id\(\s*(['"])([^'"]+)\1/g))
+            push('testid', m[2], m.index ?? 0);
+        for (const m of text.matchAll(/get_by_(?:text|label|placeholder)\(\s*(['"])([^'"]+)\1|get_by_role\([^)]*name\s*=\s*(['"])([^'"]+)\3/g))
+            push('text', m[2] ?? m[4], m.index ?? 0);
+    }
+    else {
+        for (const m of text.matchAll(TITLE_RE))
+            titles.push(unq(m[2]));
+        for (const m of text.matchAll(GOTO_RE)) {
+            const r = routeOfTarget(m[2]);
+            if (r)
+                push('route', r, m.index ?? 0);
+        }
+        for (const m of text.matchAll(REQ_RE)) {
+            const r = routeOfTarget(m[2]);
+            if (r)
+                push('route', r, m.index ?? 0);
+        }
+        for (const m of text.matchAll(TESTID_RE))
+            push('testid', m[2], m.index ?? 0);
+        for (const m of text.matchAll(ROLE_NAME_RE))
+            push('text', m[2], m.index ?? 0);
+        for (const m of text.matchAll(TEXT_RE))
+            push('text', m[2], m.index ?? 0);
+    }
+    for (const m of text.matchAll(ATTR_RE))
+        push('testid', m[1], m.index ?? 0);
+    const uniq = (k) => [...new Set(refs.filter((r) => r.kind === k).map((r) => r.value))];
+    const e2e = /@playwright\/test|from ['"]cypress['"]|\bcy\.|\bpage\.goto\(|playwright\.sync_api|from playwright|webdriverio|\bbrowser\.url\(/.test(text) ||
+        /(^|\/)(e2e|cypress|playwright)\//.test(path);
+    refs.sort((a, b) => a.line - b.line || (a.kind < b.kind ? -1 : a.kind > b.kind ? 1 : a.value < b.value ? -1 : 1));
+    return {
+        path,
+        kind: e2e ? 'e2e' : 'unit',
+        titles: [...new Set(titles)],
+        routes: uniq('route'),
+        testIds: uniq('testid'),
+        texts: uniq('text'),
+        refs,
+        smoke: !!smokeGrep && text.includes(smokeGrep),
+    };
+}
+/** Test files the import graph does not hold (for example .rb, .go, .java) are left out. */
+export function specInventory(view, graph, opts = {}) {
+    const candidates = [...new Set([...view.list(), ...(opts.extra ?? [])])].filter((f) => SPEC_CODE.test(f) && isTestFile(f) && !/\.d\.ts$/.test(f));
+    const out = [];
+    for (const path of candidates.sort().slice(0, MAX_SPECS)) {
+        const text = view.read(path);
+        if (text === null)
+            continue;
+        const info = parseSpec(path, text, opts.smokeGrep);
+        // Skip helpers in test folders that hold no test.
+        if (!info.titles.length && !info.refs.length)
+            continue;
+        let imports = [];
+        const resolved = graph?.edges.get(path);
+        if (resolved)
+            imports = [...resolved].sort();
+        else if (!graph)
+            imports = extractImports(path, text)
+                .map((i) => i.spec)
+                .filter((s) => s.startsWith('.'))
+                .map((s) => posix.normalize(posix.join(posix.dirname(path), s)));
+        out.push({ ...info, imports });
+    }
+    return out;
+}
+/** Unit tests that sit next to a source file: foo.test.ts, __tests__/foo.test.ts, test_foo.py, foo_test.go. */
+export function isNeighbourTest(spec, source) {
+    const sDir = posix.dirname(source);
+    const sStem = (source.split('/').pop() ?? '').replace(/\.[^.]+$/, '');
+    const tDir = posix.dirname(spec);
+    const tName = spec.split('/').pop() ?? '';
+    const tStem = tName
+        .replace(/\.(test|spec)\.[^.]+$/, '')
+        .replace(/^test_/, '')
+        .replace(/_test\.[^.]+$/, '')
+        .replace(/\.py$/, '');
+    if (tStem !== sStem)
+        return false;
+    if (tDir === sDir || tDir === `${sDir}/__tests__` || tDir === `${sDir}/tests` || tDir === `${sDir}/test`)
+        return true;
+    // src/foo.ts and test/foo.test.ts: a test folder beside the source folder.
+    return /^(__tests__|tests?|spec)$/.test(posix.basename(tDir)) && posix.dirname(tDir) === posix.dirname(sDir);
+}
+//# sourceMappingURL=specs.js.map

package/dist/review/specs.js.map

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

package/dist/review/ste.js

@@ -0,0 +1,133 @@
+// ASD-STE100 (Simplified Technical English) rules for text a QA engineer reads first (KAT-144):
+// the change summary on the run page and at the top of the PR comment. One source for the prompt
+// rule block, the reviewer answer check, the summary builder and the readability eval.
+//
+// The script checks what a script can check: sentence length, sentence count, passive voice,
+// banned words and file names. "One meaning per word" stays a prompt rule.
+/** An instruction (a sentence that starts with a verb) has at most 20 words. */
+export const STE_MAX_INSTRUCTION_WORDS = 20;
+/** A descriptive sentence has at most 25 words. */
+export const STE_MAX_DESCRIPTION_WORDS = 25;
+export const STE_MAX_SUMMARY_SENTENCES = 3;
+/**
+ * Words a QA engineer should not have to decode, with the everyday word to use instead.
+ * The prompt lists them, the check sends them back, the eval counts them.
+ */
+export const STE_BANNED = [
+    ['utilize', 'use'],
+    ['leverage', 'use'],
+    ['facilitate', 'help'],
+    ['implement', 'add'],
+    ['functionality', 'feature'],
+    ['robust', 'say what it survives'],
+    ['seamless', 'say what works'],
+    ['streamline', 'make shorter'],
+    ['refactor', 'restructure'],
+    ['plumbing', 'connect'],
+    ['wire up', 'connect'],
+    ['scaffold', 'add'],
+    ['under the hood', 'in the code'],
+    ['end-to-end', 'full'],
+    ['codepath', 'part of the code'],
+    ['code path', 'part of the code'],
+    ['orchestrate', 'run'],
+    ['delve', 'look'],
+    ['enhance', 'improve'],
+    ['prior to', 'before'],
+    ['in order to', 'to'],
+    ['approximately', 'about'],
+    ['commence', 'start'],
+    ['terminate', 'stop'],
+];
+const BANNED_RE = STE_BANNED.map(([w]) => [new RegExp(`\\b${w.replace(/[-\s]/g, '[-\\s]')}(s|d|ed|es|ing)?\\b`, 'i'), w]);
+/** Verbs a QA instruction starts with. A sentence that starts with one is an instruction. */
+const INSTRUCTION_VERBS = new Set('add check click compare confirm create delete edit enter fill go install open paste press read remove rename review run save select set start stop test try type update upload use watch write'.split(' '));
+/** Common irregular past participles; regular ones end in -ed. */
+const IRREGULAR_PARTICIPLES = 'built broken brought bought caught chosen done drawn driven eaten fallen felt found forgotten given gone grown held hidden hit kept known laid led left lent let lost made meant met paid put read run said seen sent set shown shut sold spent split spread stolen struck taken taught thrown told understood won written';
+/** Words that may sit between the be-verb and the participle: "is now shown", "was also removed". */
+const PASSIVE_ADVERBS = '(?:\\w+ly|now|also|only|not|still|then|never|always|already)';
+const PASSIVE_RE = new RegExp(`\\b(is|are|was|were|be|been|being|gets|got|get)\\s+(?:${PASSIVE_ADVERBS}\\s+)?(\\w{2,}ed|${IRREGULAR_PARTICIPLES.split(' ').join('|')})\\b`, 'i');
+/** "-ed" words after a be-verb that are adjectives, not participles. */
+const ED_ADJECTIVES = new Set('based needed used supposed tired interested related advanced detailed limited experienced concerned speed feed seed need started'.split(' '));
+/**
+ * A file path or file name, such as src/review/render.ts or package.json. A slash pair such as
+ * "pass/fail" or "TCP/IP" is not a path: a path needs a file extension or three segments.
+ */
+const FILE_EXT = '(?:tsx?|jsx?|mjs|cjs|css|scss|json|ya?ml|md|py|go|rs|java|kt|rb|php|cs|swift|sql|html|sh|toml|lock)';
+const FILE_RE = new RegExp(`(?:[\\w.-]+/)+[\\w-]+\\.${FILE_EXT}\\b|[\\w.-]+/[\\w.-]+/[\\w.-]+|\\b[\\w-]+\\.${FILE_EXT}\\b`, 'gi');
+/** Product names that look like file names. */
+const NOT_FILES = /^(node|next|vue|nuxt|three|express|deno|chart|ember|backbone)\.js$/i;
+export function steWords(s) {
+    return s.split(/\s+/).filter((w) => /[A-Za-z0-9]/.test(w)).length;
+}
+/** Sentences of a text. Splits on . ! ? followed by space and a capital, a digit or a quote. */
+export function steSentences(text) {
+    return text
+        .split('\n')
+        .flatMap((line) => line.trim().split(/(?<=[.!?])\s+(?=[A-Z0-9"'(`])/))
+        .map((s) => s.trim())
+        .filter((s) => steWords(s) > 0);
+}
+export function isInstruction(sentence) {
+    const first = sentence
+        .replace(/^[^A-Za-z]+/, '')
+        .split(/\s+/)[0]
+        ?.toLowerCase() ?? '';
+    return INSTRUCTION_VERBS.has(first);
+}
+export function wordLimit(sentence) {
+    return isInstruction(sentence) ? STE_MAX_INSTRUCTION_WORDS : STE_MAX_DESCRIPTION_WORDS;
+}
+/** The passive phrase in a sentence, such as "was removed", or null. A heuristic: it misses some, and says so in the docs. */
+export function passivePhrase(sentence) {
+    const m = PASSIVE_RE.exec(sentence);
+    if (!m)
+        return null;
+    if (ED_ADJECTIVES.has(m[2].toLowerCase()))
+        return null;
+    return m[0];
+}
+export function bannedWords(text) {
+    return BANNED_RE.filter(([re]) => re.test(text)).map(([, w]) => w);
+}
+export function mentionsFile(text) {
+    return [...text.matchAll(FILE_RE)].some((m) => !NOT_FILES.test(m[0]));
+}
+export function steCheck(text) {
+    const ss = steSentences(text);
+    const long = ss.filter((s) => steWords(s) > wordLimit(s));
+    const passive = ss.map(passivePhrase).filter((p) => !!p);
+    const banned = bannedWords(text);
+    const fileNames = mentionsFile(text);
+    return { sentences: ss.length, long, passive, banned, fileNames, ok: !long.length && !passive.length && !banned.length && !fileNames };
+}
+/** Errors a reviewer gets back for its changeSummary field. Passive voice stays a prompt rule: the heuristic is too loose to loop on. */
+export function steErrors(label, text) {
+    const out = [];
+    const ss = steSentences(text);
+    if (ss.length < 2 || ss.length > STE_MAX_SUMMARY_SENTENCES)
+        out.push(`${label} has ${ss.length} sentences; write 2 or 3.`);
+    for (const s of ss) {
+        const n = steWords(s);
+        const max = wordLimit(s);
+        if (n > max)
+            out.push(`${label} has a sentence of ${n} words ("${s.slice(0, 48)}..."); use at most ${max}.`);
+    }
+    if (mentionsFile(text))
+        out.push(`${label} names a file; describe what the user sees instead.`);
+    const banned = bannedWords(text);
+    if (banned.length)
+        out.push(`${label} uses ${banned.map((w) => `"${w}"`).join(', ')}; use ${banned.map((w) => STE_BANNED.find(([b]) => b === w)?.[1]).join(', ')}.`);
+    return out;
+}
+/** The STE rule block for the QA review prompt. */
+export function steRuleBlock() {
+    return `Change summary rules (ASD-STE100, Simplified Technical English). changeSummary is the first thing a QA engineer reads on the run page and the PR comment. Write it for a person who will not read the diff:
+- Write 2 or 3 sentences. Say what the change does for a user, then what it changes in behavior.
+- A descriptive sentence has at most ${STE_MAX_DESCRIPTION_WORDS} words. An instruction has at most ${STE_MAX_INSTRUCTION_WORDS} words and starts with the verb.
+- Use the active voice. Name the actor: "The page now shows", not "is now shown".
+- Use one word for one meaning, and the same word every time. Do not switch between "dot", "agent" and "bot".
+- No file names, paths, function names, ids or line numbers. Name the screen, the flow or the setting.
+- Use everyday words. Do not use: ${STE_BANNED.map(([w, use]) => `${w} (use "${use}")`).join(', ')}.`;
+}
+//# sourceMappingURL=ste.js.map

package/dist/review/ste.js.map

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

package/dist/review/test-repo-file.js

@@ -0,0 +1,18 @@
+// The file of a test case that ran in a Tests repo (KAT-86). The report of a run merges the cases of the app repo's own tests and of
+// each Tests repo, and one file name can exist in both, so a case of a Tests repo names its file as `owner/name:path`, with the repo
+// in lower case. Results, flaky keys, evidence, bug signatures and defect drafts all read that one name.
+const PREFIXED = /^([A-Za-z0-9][A-Za-z0-9-]{0,38}\/[A-Za-z0-9._-]{1,100}):(.+)$/;
+/** The file of a case that ran in the Tests repo `repo` ("owner/name"). */
+export function testRepoFile(repo, path) {
+    return `${repo.toLowerCase()}:${path}`;
+}
+/** The repo and the path of a case file. A file with no `owner/name:` in front belongs to the app repo's own tests. */
+export function splitTestRepoFile(file) {
+    const m = PREFIXED.exec(file);
+    return m ? { repo: m[1].toLowerCase(), path: m[2] } : { path: file };
+}
+/** True for a case file of a Tests repo. */
+export function isTestRepoFile(file) {
+    return PREFIXED.test(file);
+}
+//# sourceMappingURL=test-repo-file.js.map

package/dist/review/test-repo-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-repo-file.js","sourceRoot":"","sources":["../../src/review/test-repo-file.ts"],"names":[],"mappings":"AAAA,qIAAqI;AACrI,qIAAqI;AACrI,yGAAyG;AAEzG,MAAM,QAAQ,GAAG,+DAA+D,CAAC;AAEjF,2EAA2E;AAC3E,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAY;IACrD,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACzE,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/review/test-repo-lines.js

@@ -0,0 +1,53 @@
+/** The tests that ran to the end: passed, failed and flaky. A skipped test did not run, so it is never counted here (KAT-402). */
+export function testsRan(r) {
+    return r.passed + r.failed + r.flaky;
+}
+/** "53 were skipped (they do not apply to this project)." The one sentence for tests the run skipped (KAT-402). */
+export function skippedSentence(n) {
+    return `${n} ${n === 1 ? 'was' : 'were'} skipped (${n === 1 ? 'it does' : 'they do'} not apply to this project).`;
+}
+const RULE_WORDS = {
+    directive: 'the PR description names it',
+    match_branch: 'the PR branch exists in the Tests repo',
+    fixed: "the dot's settings name it",
+    default: 'the default branch',
+};
+/** Why this ref ran, in a few words. */
+export function refRuleWords(rule) {
+    return RULE_WORDS[rule];
+}
+/**
+ * One line for a person: "Ran 24 True Platform tests from true-dogfood-tests: 23 passed, 1 failed.", or why nothing ran. A skipped
+ * test did not run (KAT-402), so it stays out of "Ran" and gets its own sentence: "Ran 85 tests from e2e: 85 passed. 53 were
+ * skipped (they do not apply to this project)." A batch of skipped tests only says that all of them were skipped.
+ */
+export function testRepoSentence(t) {
+    if (t.notRun)
+        return `${t.notRunOnPurpose ? `The Tests repo ${t.name} was skipped` : `The Tests repo ${t.name} could not be run`}: ${t.notRun.replace(/[.\s]+$/, '')}.`;
+    const total = t.passed + t.failed + t.flaky + t.skipped;
+    if (!total)
+        return `The Tests repo ${t.name} had no tests to run.`;
+    const ran = testsRan(t);
+    const what = `${t.label ? `${t.label} ` : ''}${total === 1 ? 'test' : 'tests'}`;
+    if (!ran)
+        return `${t.skipped === 1 ? `The ${what} from ${t.name} was` : `All ${t.skipped} ${what} from ${t.name} were`} skipped (${t.skipped === 1 ? 'it does' : 'they do'} not apply to this project).`;
+    const parts = [`${t.passed} passed`];
+    if (t.failed)
+        parts.push(`${t.failed} failed`);
+    if (t.flaky)
+        parts.push(`${t.flaky} passed on retry`);
+    const head = `Ran ${ran} ${t.label ? `${t.label} ` : ''}${ran === 1 ? 'test' : 'tests'} from ${t.name}: ${parts.join(', ')}.`;
+    return t.skipped ? `${head} ${skippedSentence(t.skipped)}` : head;
+}
+/** The developer detail of one Tests repo batch: the repo, the ref and commit, why that ref, the tests chosen, and the URL. */
+export function testRepoDetail(t) {
+    if (!t.sha)
+        return `${t.repo}: ${t.notRun ?? 'not run'}`;
+    const parts = [`${t.repo} at ${t.ref} (${t.sha.slice(0, 7)}), because ${refRuleWords(t.refRule)}`, `tests: ${t.selection || 'the whole suite'}`];
+    if (t.baseUrl)
+        parts.push(`against ${t.baseUrl}`);
+    if (t.note)
+        parts.push(t.note.replace(/[.\s]+$/, ''));
+    return `${parts.join('; ')}.`;
+}
+//# sourceMappingURL=test-repo-lines.js.map

package/dist/review/test-repo-lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-repo-lines.js","sourceRoot":"","sources":["../../src/review/test-repo-lines.ts"],"names":[],"mappings":"AAIA,kIAAkI;AAClI,MAAM,UAAU,QAAQ,CAAC,CAAkD;IACzE,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;AACvC,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,eAAe,CAAC,CAAS;IACvC,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,8BAA8B,CAAC;AACpH,CAAC;AAED,MAAM,UAAU,GAA2C;IACzD,SAAS,EAAE,6BAA6B;IACxC,YAAY,EAAE,wCAAwC;IACtD,KAAK,EAAE,4BAA4B;IACnC,OAAO,EAAE,oBAAoB;CAC9B,CAAC;AAEF,wCAAwC;AACxC,MAAM,UAAU,YAAY,CAAC,IAA4B;IACvD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAc;IAC7C,IAAI,CAAC,CAAC,MAAM;QACV,OAAO,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,mBAAmB,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,CAAC;IAC5J,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC;IACxD,IAAI,CAAC,KAAK;QAAE,OAAO,kBAAkB,CAAC,CAAC,IAAI,uBAAuB,CAAC;IACnE,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAChF,IAAI,CAAC,GAAG;QACN,OAAO,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,IAAI,IAAI,SAAS,CAAC,CAAC,IAAI,OAAO,aAAa,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,8BAA8B,CAAC;IAClM,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC;IACrC,IAAI,CAAC,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC;IAC/C,IAAI,CAAC,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,kBAAkB,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC9H,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACpE,CAAC;AAED,+HAA+H;AAC/H,MAAM,UAAU,cAAc,CAAC,CAAc;IAC3C,IAAI,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;IACzD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,cAAc,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,SAAS,IAAI,iBAAiB,EAAE,CAAC,CAAC;IACjJ,IAAI,CAAC,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IACtD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAChC,CAAC"}

package/dist/review/ticket-on-demand.js

@@ -0,0 +1,232 @@
+// Ticket review on demand (KAT-98): a person points the dot at a Jira, Linear, or GitHub issue,
+// by URL or key, from chat or POST /api/dots/:id/review { ticket }. The dot reads the ticket
+// through the connected tracker and runs the same ticket_review job the webhook and the poller
+// queue, so the comment goes through the dot's rules (ask first by default).
+import { list } from '../db.js';
+import { jiraFor } from '../integrations/jira.js';
+import { linearFor } from '../integrations/linear.js';
+import { githubMode } from '../integrations/github.js';
+import { bodyHash, issueApi, parseIssueRef, trackerRepos } from '../integrations/github-issues.js';
+import { trackerProjectKeys } from '../ticket-keys.js';
+import { enqueue } from '../queue.js';
+import { dispatchTrigger } from '../webhooks.js';
+const JIRA_URL = /\bhttps?:\/\/([a-z0-9.-]+)(?::\d+)?\/(?:browse\/|[^\s]*?[?&](?:selectedIssue|issueKey)=)([A-Z][A-Z0-9_]{0,19}-\d{1,9})\b[^\s)>\]]*/gi;
+const LINEAR_URL = /\bhttps?:\/\/linear\.app\/[\w-]+\/issue\/([A-Z][A-Z0-9]{0,9}-\d{1,9})\b[^\s)>\]]*/gi;
+const GITHUB_ISSUE_URL = /\bhttps?:\/\/github\.com\/([\w.-]+)\/([\w.-]+)\/issues\/(\d{1,9})\b[^\s)>\]]*/gi;
+const BARE_KEY = /(?<![\w/-])([A-Z][A-Z0-9]{1,9}-\d{1,9})(?![\w-])/g;
+const trackerKeys = trackerProjectKeys;
+/**
+ * Every ticket a chat line or a request names, in order: Jira browse URLs, Linear issue URLs,
+ * GitHub issue URLs, and bare keys such as TAD-3 whose prefix is one of the dot's tracker keys.
+ * A bare key with another prefix is ignored, so "UTF-8" or "ES-2015" is not a ticket.
+ */
+export function findTicketRefs(text, w) {
+    const out = [];
+    const seen = new Set();
+    const push = (r) => {
+        const id = `${r.tracker}:${r.key}`;
+        if (!seen.has(id)) {
+            seen.add(id);
+            out.push(r);
+        }
+    };
+    let rest = text;
+    for (const m of text.matchAll(LINEAR_URL)) {
+        push({ tracker: 'linear', key: m[1].toUpperCase(), url: m[0] });
+        rest = rest.replace(m[0], ' ');
+    }
+    for (const m of text.matchAll(GITHUB_ISSUE_URL)) {
+        push({ tracker: 'github', key: `${m[1]}/${m[2]}#${m[3]}`, url: m[0], owner: m[1], repo: m[2], number: Number(m[3]) });
+        rest = rest.replace(m[0], ' ');
+    }
+    for (const m of text.matchAll(JIRA_URL)) {
+        if (/(^|\.)(github\.com|linear\.app)$/i.test(m[1]))
+            continue;
+        let origin;
+        try {
+            origin = new URL(m[0]).origin;
+        }
+        catch {
+            /* matched text is not a URL */
+        }
+        push({ tracker: 'jira', key: m[2].toUpperCase(), url: m[0], ...(origin ? { origin } : {}) });
+        rest = rest.replace(m[0], ' ');
+    }
+    const keys = trackerKeys(w);
+    const kind = w?.tracker?.kind;
+    if (keys.length && (kind === 'jira' || kind === 'linear')) {
+        for (const m of rest.matchAll(BARE_KEY)) {
+            const key = m[1].toUpperCase();
+            if (keys.includes(key.split('-')[0]))
+                push({ tracker: kind, key });
+        }
+    }
+    return out;
+}
+/** Reads `ticket` from a request body or a tool input: a URL or a key. */
+export function parseTicketInput(value, w) {
+    const raw = typeof value === 'string' ? value.trim() : '';
+    if (!raw)
+        return { ok: false, error: 'ticket must be a ticket URL or a key such as SHOP-12.' };
+    const found = findTicketRefs(raw, w);
+    if (found[0])
+        return { ok: true, ref: found[0] };
+    // owner/name#12, or #12 on a dot whose GitHub Issues tracker reads one repo.
+    const gh = parseIssueRef(raw);
+    if (gh)
+        return { ok: true, ref: { tracker: 'github', key: `${gh.full}#${gh.number}`, owner: gh.owner, repo: gh.name, number: gh.number } };
+    const hash = /^#(\d{1,9})$/.exec(raw);
+    const repos = w ? trackerRepos(w) : [];
+    if (hash && w?.tracker?.kind === 'github' && repos.length === 1) {
+        const [owner, repo] = repos[0].split('/');
+        return { ok: true, ref: { tracker: 'github', key: `${repos[0]}#${hash[1]}`, owner, repo, number: Number(hash[1]) } };
+    }
+    // A bare key the dot's tracker keys do not list: use the dot's tracker when it has one.
+    const key = /^([A-Za-z][A-Za-z0-9]{0,9}-\d{1,9})$/.exec(raw)?.[1]?.toUpperCase();
+    const kind = w?.tracker?.kind;
+    if (key && (kind === 'jira' || kind === 'linear'))
+        return { ok: true, ref: { tracker: kind, key } };
+    if (key)
+        return { ok: false, error: `${w?.name ?? 'This dot'} has no Jira or Linear tracker, so ${key} cannot be looked up. Send the full ticket URL.` };
+    return { ok: false, error: 'That is not a Jira, Linear, or GitHub issue URL or key.' };
+}
+const trimSlash = (s) => s.replace(/\/+$/, '');
+/** Jira client for the ref, or why there is none. The URL's site must be the connected one. */
+function jiraForRef(w, ref) {
+    const client = jiraFor(w);
+    if (client.mode !== 'live')
+        return { ok: false, error: 'Jira is not connected. Connect it on the Setup page (site URL, email, and API token), then ask again.' };
+    const base = trimSlash(client.baseUrl ?? '');
+    if (ref.origin && base && trimSlash(ref.origin).toLowerCase() !== new URL(base).origin.toLowerCase())
+        return { ok: false, error: `That ticket is on ${ref.origin}, but the connected Jira site is ${new URL(base).origin}.` };
+    return { ok: true, client };
+}
+/** Reads the ticket through the connected tracker. Errors say what is missing in words. */
+export async function fetchTicketRef(w, ref) {
+    try {
+        if (ref.tracker === 'jira') {
+            const j = jiraForRef(w, ref);
+            if (!j.ok)
+                return { ok: false, code: 409, error: j.error };
+            return { ok: true, ticket: await j.client.getIssue(ref.key) };
+        }
+        if (ref.tracker === 'linear') {
+            const client = linearFor(w);
+            if (client.mode !== 'live')
+                return { ok: false, code: 409, error: 'Linear is not connected. Connect it on the Setup page (API key), then ask again.' };
+            return { ok: true, ticket: await client.getIssue(ref.key) };
+        }
+        // GitHub issues (KAT-87): read through the GitHub connection, from a repo the dot watches.
+        if (githubMode() === 'demo')
+            return { ok: false, code: 409, error: 'GitHub is not connected. Connect it on the Setup page, then ask again.' };
+        const full = `${ref.owner}/${ref.repo}`.toLowerCase();
+        const watched = new Set([...trackerRepos(w), ...(w.repo ? [`${w.repo.owner}/${w.repo.name}`.toLowerCase()] : [])]);
+        if (!watched.has(full))
+            return {
+                ok: false,
+                code: 409,
+                error: `${w.name} does not watch ${ref.owner}/${ref.repo}, so it cannot review that issue. Add the repo to the dot's GitHub Issues tracker.`,
+            };
+        return { ok: true, ticket: await issueApi(`${ref.owner}/${ref.repo}`).getIssue(ref.number) };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (/is a pull request, not an issue/.test(msg))
+            return { ok: false, code: 409, error: `${ref.key} is a pull request. Ask me to review the PR instead.` };
+        if (/HTTP 404|not found|Entity not found/i.test(msg))
+            return { ok: false, code: 404, error: `${ref.key} was not found, or the connected account cannot see it.` };
+        if (/HTTP 401|HTTP 403/i.test(msg))
+            return {
+                ok: false,
+                code: 502,
+                error: `The tracker refused to show ${ref.key} (${/HTTP (\d+)/.exec(msg)?.[1]}). Check the connection on the Setup page.`,
+            };
+        return { ok: false, code: 502, error: `Could not read ${ref.key}: ${msg.slice(0, 200)}` };
+    }
+}
+const stamp = () => `${Date.now().toString(36)}${Math.random().toString(36).slice(2, 6)}`;
+/** A queued or running ticket_review job of this dot for the same ticket. */
+export function activeTicketReviewJob(watchId, tracker, key) {
+    return list('jobs', { watchId, kind: 'ticket_review', status: ['queued', 'running'] }).find((j) => {
+        const t = j.payload?.ticket;
+        return t?.tracker === tracker && t.key === key;
+    });
+}
+/**
+ * Queues a ticket review for the dot. Same job, flow, and rules gate as a new ticket from the
+ * webhook or the poller; a review of the same ticket still queued or running is returned instead.
+ */
+export async function requestTicketReview(w, ref, opts) {
+    if (w.archived)
+        return { ok: false, code: 409, error: `${w.name} is archived.` };
+    if (w.paused)
+        return { ok: false, code: 409, error: `${w.name} is paused. Resume it to review.` };
+    const fetched = await fetchTicketRef(w, ref);
+    if (!fetched.ok)
+        return fetched;
+    const ticket = fetched.ticket;
+    const tracker = ticket.tracker;
+    const title = `${ticket.key}: ${ticket.title}`;
+    const active = activeTicketReviewJob(w.id, tracker, ticket.key);
+    if (active)
+        return { ok: true, duplicate: true, jobId: active.id, title, ticket };
+    const ev = {
+        source: tracker,
+        kind: 'ticket_created',
+        dedupeKey: `review:${tracker}:${ticket.key}:${stamp()}`,
+        title,
+        ticket: tracker === 'github'
+            ? { key: ticket.key, id: ticket.id, tracker, projectKey: ticket.key.split('#')[0], bodyHash: bodyHash(ticket.title, ticket.description) }
+            : { key: ticket.key, id: ticket.id, tracker, projectKey: ticket.key.split('-')[0] },
+        ...(tracker === 'github' ? { repo: { owner: ticket.key.split('/')[0], name: ticket.key.split('/')[1].split('#')[0] } } : {}),
+        inlineTicket: ticket,
+        requestedBy: opts.requestedBy,
+        ...(ticket.url ? { url: ticket.url } : {}),
+    };
+    const res = dispatchTrigger(ev, { watchIds: [w.id] });
+    const job = res.jobs[0];
+    if (!res.accepted || !job)
+        return { ok: false, code: 409, error: res.reason ?? 'The review was not queued.' };
+    return { ok: true, duplicate: false, jobId: job.jobId, title, ticket };
+}
+/** A queued or running test_design job of this dot for the same ticket. */
+export function activeTestDesignJob(watchId, tracker, key) {
+    return list('jobs', { watchId, kind: 'test_design', status: ['queued', 'running'] }).find((j) => {
+        const t = j.payload?.ticket;
+        return t?.tracker === tracker && t.key === key;
+    });
+}
+/**
+ * Queues the test designer for a ticket the dot can read (chat tool design_tests). The job stores draft cases and
+ * posts nothing outward, so no approval is involved. A design of the same ticket still queued or running is
+ * returned instead of a second job.
+ */
+export async function requestTestDesign(w, ref, opts) {
+    if (w.archived)
+        return { ok: false, code: 409, error: `${w.name} is archived.` };
+    if (w.paused)
+        return { ok: false, code: 409, error: `${w.name} is paused. Resume it to design tests.` };
+    const fetched = await fetchTicketRef(w, ref);
+    if (!fetched.ok)
+        return fetched;
+    const ticket = fetched.ticket;
+    const title = `${ticket.key}: ${ticket.title}`;
+    const active = activeTestDesignJob(w.id, ticket.tracker, ticket.key);
+    if (active)
+        return { ok: true, duplicate: true, jobId: active.id, title, ticket };
+    const ev = {
+        source: ticket.tracker,
+        kind: 'chat',
+        dedupeKey: `design:${ticket.tracker}:${ticket.key}:${stamp()}`,
+        title,
+        ticket: { key: ticket.key, id: ticket.id, tracker: ticket.tracker, projectKey: ticket.key.split(/[-#]/)[0] },
+        inlineTicket: ticket,
+        requestedBy: opts.requestedBy,
+        ...(ticket.url ? { url: ticket.url } : {}),
+    };
+    const jobId = enqueue({ kind: 'test_design', watchId: w.id, dedupeKey: ev.dedupeKey, payload: ev });
+    if (!jobId)
+        return { ok: false, code: 409, error: 'The test design was not queued.' };
+    return { ok: true, duplicate: false, jobId, title, ticket };
+}
+//# sourceMappingURL=ticket-on-demand.js.map